Create project

POST/v1/projects

Signed-in sessionLaunch key product.projectsOperation project_create

People plan work as projects with tasks, sprints, a board, a backlog, a timeline and a dashboard, and write shared documents in one editor with history and media.

Body

planningTimeZonestring
goalstring
visibility"private" | "tenant"Required
namestringRequired
keystringRequired
ownerActorIdstringRequired
expectedAuthorizationVersionstringRequired
receiptobjectRequired

Returns

projectIdstringRequired
versionnumberRequired

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.

POST/v1/projects

curl "$SPECIFY_API_ORIGIN/v1/projects" \
  -X POST \
  -H "Authorization: Bearer $SPECIFY_SESSION_TOKEN" \
  -H "X-Specify-Account-Id: <accountId>" \
  -H "X-Specify-Service-Tenancy-Id: <serviceTenancyId>" \
  -H "Content-Type: application/json" \
  -d '{"visibility":"private","name":"<name>","key":"<key>","ownerActorId":"<ownerActorId>","expectedAuthorizationVersion":"<expectedAuthorizationVersion>","receipt":{"key":"<key>","operation":"<operation>","requestHash":"<requestHash>","issuedAt":1}}'

Response

{
  "result": {
    "projectId": "<projectId>",
    "version": 1
  }
}

Create project

Headers

Body

Returns

Errors