Create a project

curl -X POST https://api.subscriby.net/v1/projects \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Premium",
    "description": "Weekly deep-dive research notes.",
    "handle": "research-premium",
    "metrics": true
  }'

Banner and photo are optional image uploads. Send multipart/form-data when you want the API to accept the raw image:

curl -X POST https://api.subscriby.net/v1/projects \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "name=Research Premium" \
  -F "description=Weekly deep-dive research notes." \
  -F "banner=@./banner.jpg" \
  -F "photo=@./avatar.jpg"

Answers 201 with the project and emits project.created. Creating a project enforces the creator's tier project limit; exceeding it is 403 TEAM_TIER_REQUIRED with a required_capability hint in error.context.

Validation rules

Enforced on both create and update (every field is optional on update):

• name: required on create. String, 5–255 characters.
• description: optional. String, max 1,000 characters. HTML is filtered to a safe subset before storage.
• terms, privacy: optional. URLs, max 255 characters each.
• banner, photo: optional. Image uploads, max 5 MB each, sent as multipart/form-data.
• handle: optional. Lowercase alpha-dash ASCII, 5–255 characters, unique. Requires a Subscriby tier that includes the custom-handle capability; Free-tier tokens receive TEAM_TIER_REQUIRED when a handle is supplied.
• metrics, active: optional booleans.
• outage_compensations: optional boolean, true on every new project. Outage Compensation: when a platform refuses the project's connector for an hour or more and later answers again, every member whose paid access overlapped the gap gets the lost time added to the end of their access automatically, so nobody pays for days they could not use. Set it to false when the creator would rather settle outages themselves, for example with refunds or coupons. See Connector outages.
• team_id: optional UUID; must be a team the token's owner belongs to. Defaults to the token's scoped team.

Artwork is processed after the request. The response body returns the project's metadata only, not the hosted image URLs. Image processing (resize, re-encode, upload to storage) runs on the server after a successful create or update; clients that need the hosted URL should fetch the project once upload is complete.