POST · projects:write

Create project

Create a new monitoring project with Daily Digest enabled at 8 AM in digestTimezone (UTC by default), within workspace limits. Digests email the workspace owner and can be disabled or deleted through alerts.

External side effects

REST

POST/api/v1/projects

curl "https://www.stalkr.ai/api/v1/projects" \
  --request POST \
  --header "Authorization: Bearer $STALKR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: unique-operation-key"

MCP

Tool name: create_project

The MCP tool accepts the same input schema and returns the same structured { data, meta } result as REST.

Input

digestTimezonerequired

string

Timezone for the automatic 8 AM daily digest; defaults to UTC

namerequired

string

descriptionrequired

string

colorrequired

string

iconrequired

string

enabledSourcesrequired

array

idempotencyKey

string

Unique key used to safely retry this write operation

Safe retries

Pass idempotencyKey to the MCP tool or Idempotency-Key to REST when retrying this write.

Authorization

Required scope: projects:write.

Scope authorization is followed by resource authorization. Project operations check current membership and the minimum role required by the underlying workflow.

Related resources

REST conventions · MCP setup · Errors and limits