Skip to content
Cloud
Docs

Projects API reference

The Socra project service — account-local cloud/developer containers.

Published contracts: @socra/project-api@0.0.3.

Base URL

https://project.socra.cloud

Projects

An account-local cloud/developer boundary.

Create project

POST/v1/projects

Request body

slugstringrequired
min length: 1 · max length: 64 · pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Response

5 fields

idcustomrequired
slugstringrequired
status"active" | "suspended"required
created_atcustomrequired
updated_atcustomrequired

List projects

GET/v1/projects

Query parameters

limitintegeroptional
min: 1 · max: 100
afterstringoptional

Response

2 fields

dataobject[]required
idcustomrequired
slugstringrequired
status"active" | "suspended"required
created_atcustomrequired
updated_atcustomrequired
has_morebooleanrequired

Get project

GET/v1/projects/{id}

Path parameters

idcustomrequired

Query parameters

No query parameters

Response

5 fields

idcustomrequired
slugstringrequired
status"active" | "suspended"required
created_atcustomrequired
updated_atcustomrequired

Update project

PATCH/v1/projects/{id}

Path parameters

idcustomrequired

Request body

status"active" | "suspended"optional

Response

5 fields

idcustomrequired
slugstringrequired
status"active" | "suspended"required
created_atcustomrequired
updated_atcustomrequired

Delete project

DELETE/v1/projects/{id}

Path parameters

idcustomrequired

Query parameters

No query parameters

Response

No response body