POST /api/v1/workspaces/{workspace_id}/pins

Use this endpoint to add pin.

Endpoint

• Method: POST

• Path: /api/v1/workspaces/{workspace_id}/pins

• Required scope: pin:write

• Base URL: https://dokki.one

• Route source: app/api/v1/workspaces/[workspaceId]/pins/route.ts

Parameters

• workspace_id: path identifier

Send a JSON request body with only supported fields.

Request example

curl -X POST "https://dokki.one/api/v1/workspaces/{workspace_id}/pins"
  -H "Authorization: Bearer $DOKKI_API_KEY"
  -H "Content-Type: application/json"
  -d '{"TODO":"replace with endpoint-specific fields"}'

Response

Successful responses are JSON. Preserve request_id values and treat resource identifiers as opaque UUIDs.

{
  "data": {},
  "request_id": "req_..."
}

Errors

• 400 invalid request

• 401 missing or invalid authentication

• 403 insufficient scope or tenant access

• 404 resource not found

• 409 conflicting state

• 429 rate limit exceeded

Log request_id with every error. See https://dokki.one/pub/api/authentication and https://dokki.one/pub/api/api-conventions.