fp2 documentation

curl -X PATCH https://new.fp.dev/api/v1/projects/projectId/issues/reference/status \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "status": "todo",
  "expected_status": "todo",
  "client_id": "string"
}'

{
  "issue": {
    "id": "string",
    "display_id": "string",
    "project_id": "string",
    "title": "string",
    "body": "string",
    "status": "todo",
    "priority": "urgent",
    "parent_id": "string",
    "created_by": {
      "kind": "user",
      "id": "string"
    },
    "created_at": "string",
    "updated_at": "string"
  },
  "transition": {
    "id": "string",
    "project_id": "string",
    "issue_id": "string",
    "from_status": "todo",
    "to_status": "todo",
    "actor": {
      "kind": "user",
      "id": "string"
    },
    "created_at": "string"
  },
  "actions": [
    {
      "name": "string",
      "title": "string",
      "method": "POST",
      "href": "string",
      "effect": "safe",
      "reversible": true,
      "fields": [
        {
          "kind": "constant",
          "name": "string",
          "value": "string"
        }
      ]
    }
  ],
  "blocked": [
    {
      "name": "string",
      "reason_code": "illegal_edge",
      "message": "string"
    }
  ]
}

Atomically moves an issue through a legal status edge. expected_status is a compare-and-set precondition; client_id makes an uncertain result safe to replay.

Authentication

AuthorizationBearer

Pass an attributable fp2 API key as Authorization: Bearer <key>. Never embed keys in repositories or documentation.

Path parameters

projectIdstringRequired

referencestringRequired

Request

This endpoint expects an object.

statusenumRequired

Allowed values:

expected_statusenumRequired

Allowed values:

client_idanyRequired

Response

Success

issueobject

transitionobject

actionslist of objects

blockedlist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error