D

Create comments

POST /api/v1/resources/{resource_id}/comments

Use this endpoint to create comments.

Endpoint

  • Method: POST

  • Path: /api/v1/resources/{resource_id}/comments

  • Required scope: comment:write

  • Base URL: https://dokki.one

  • Route source: app/api/v1/resources/[resourceId]/comments/route.ts

Parameters

  • resource_id: path identifier

Send a JSON request body with only supported fields.

Request example

curl -X POST "https://dokki.one/api/v1/resources/{resource_id}/comments"
  -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.

{
  "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