Problems

{
  "type": "https://developers.plnnrly.com/api/v2/problems/duplicate-resource",
  "title": "Duplicate resource",
  "status": 409,
  "detail": "Another project already uses the code \"ACM\".",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "conflict": {
    "field": "code",
    "value": "ACM"
  }
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/endpoint-not-found",
  "title": "Endpoint not found",
  "status": 404,
  "detail": "No API endpoint matches this request.",
  "instance": "/api/v2/nope",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/endpoint-retired",
  "title": "Endpoint retired",
  "status": 410,
  "detail": "This endpoint has been retired and no longer serves requests.",
  "instance": "/api/v2/projects/4711/statistics",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "sunset": "2027-09-01",
  "replaced_by": "api.v2.projects.show"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/forbidden-by-policy",
  "title": "Forbidden by policy",
  "status": 403,
  "detail": "You may not perform this operation on this record.",
  "instance": "/api/v2/projects/4711",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/idempotency-key-in-flight",
  "title": "Idempotency key in flight",
  "status": 409,
  "detail": "The original request for this Idempotency-Key is still being processed. Retry shortly.",
  "instance": "/api/v2/worklogs",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/idempotency-key-required",
  "title": "Idempotency key required",
  "status": 400,
  "detail": "This endpoint requires an Idempotency-Key header.",
  "instance": "/api/v2/worklogs",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/idempotency-key-reused",
  "title": "Idempotency key reused",
  "status": 409,
  "detail": "This Idempotency-Key was already used with a different request body.",
  "instance": "/api/v2/worklogs",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/insufficient-permission",
  "title": "Insufficient permission",
  "status": 403,
  "detail": "Your role does not carry the permission this endpoint requires.",
  "instance": "/api/v2/projects/4711",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "required_permission": "projects::read"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/insufficient-token-scope",
  "title": "Insufficient token scope",
  "status": 403,
  "detail": "This token does not carry an ability that covers this endpoint.",
  "instance": "/api/v2/drive-documents/91",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "required_ability": [
    "api:read:project_drive",
    "api:read:customer_drive"
  ]
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/internal-error",
  "title": "Internal error",
  "status": 500,
  "detail": "An unexpected error occurred. Quote the request_id when contacting support.",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/invalid-cursor",
  "title": "Invalid cursor",
  "status": 400,
  "detail": "The cursor is not valid for this query. Restart the scan without a cursor.",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/invalid-query-parameter",
  "title": "Invalid query parameter",
  "status": 400,
  "detail": "1 query parameter was not recognised or not permitted on this resource.",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "errors": [
    {
      "parameter": "limit",
      "code": "unknown_parameter",
      "detail": "Unknown query parameter \"limit\". Allowed: filter[…], sort, include, q, trashed, per_page, cursor, page, with_total, view, meta, force, url_ttl_minutes."
    }
  ]
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/malformed-request",
  "title": "Malformed request",
  "status": 400,
  "detail": "The request could not be read.",
  "instance": "/api/v2/worklogs",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/method-not-allowed",
  "title": "Method not allowed",
  "status": 405,
  "detail": "PUT is not supported. This API patches: use PATCH with only the fields you are changing.",
  "instance": "/api/v2/projects/4711",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/not-acceptable",
  "title": "Not acceptable",
  "status": 406,
  "detail": "This API only produces application/json. Send an Accept header that allows it.",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/precondition-failed",
  "title": "Precondition failed",
  "status": 412,
  "detail": "The record changed since the version named in If-Match. Re-read it and retry.",
  "instance": "/api/v2/work-items/812",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "current_version": 12
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/rate-limit-exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "The rate limit for this caller has been exhausted. Retry after the interval in the Retry-After header.",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "rate_limit": {
    "limit": 600,
    "retry_after": 42
  }
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/resource-not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "No Project was found with id 4711.",
  "instance": "/api/v2/projects/4711",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/state-conflict",
  "title": "State conflict",
  "status": 409,
  "detail": "The target status is not reachable from this work item's current status.",
  "instance": "/api/v2/work-items/812/actions/transition",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "conflict": {
    "reason": "illegal_transition",
    "from_workflow_status_id": 3,
    "to_workflow_status_id": 9
  }
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/tenant-unavailable",
  "title": "Tenant unavailable",
  "status": 503,
  "detail": "This organisation is provisioning, suspended or archived, or the service is down for maintenance.",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/token-expired",
  "title": "Token expired",
  "status": 401,
  "detail": "This token has expired. Create a new one under API access in your user menu.",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "expired_at": "2026-08-01T09:00:00Z"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/unauthenticated",
  "title": "Unauthenticated",
  "status": 401,
  "detail": "No valid bearer token was supplied.",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/unprocessable-relationship",
  "title": "Unprocessable relationship",
  "status": 422,
  "detail": "1 referenced record cannot be used here.",
  "instance": "/api/v2/work-items",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "errors": [
    {
      "pointer": "/sprint_id",
      "code": "exists",
      "detail": "Sprint 55 belongs to another project and cannot be used here."
    }
  ]
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/unsupported-media-type",
  "title": "Unsupported media type",
  "status": 415,
  "detail": "This API only accepts application/json request bodies.",
  "instance": "/api/v2/worklogs",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S"
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/unsupported-parameter",
  "title": "Unsupported parameter",
  "status": 400,
  "detail": "1 query parameter is not supported on this endpoint.",
  "instance": "/api/v2/projects",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "errors": [
    {
      "parameter": "fields",
      "code": "unsupported_parameter",
      "detail": "Sparse fieldsets are not supported by this API. Use view=summary or view=detail instead."
    }
  ]
}

{
  "type": "https://developers.plnnrly.com/api/v2/problems/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "3 fields failed validation.",
  "instance": "/api/v2/worklogs",
  "request_id": "01K4B7Q9YV3PZ2N8T1E6M0XR4S",
  "errors": [
    {
      "pointer": "/date",
      "code": "date_format",
      "detail": "The date does not match the format Y-m-d."
    },
    {
      "pointer": "/minutes",
      "code": "min",
      "detail": "The minutes must be at least 1."
    },
    {
      "pointer": "/description",
      "code": "required",
      "detail": "The description field is required."
    }
  ]
}