Create issue assign

POST/workspaces/{organizationId}/issues/{id}/assign

Authorization

AuthorizationBearer token · headerrequired

Workspace API key (Authorization: Bearer <key>). Issue keys under Settings → Developer or POST /workspaces/{organizationId}/tokens.

Path parameters

organizationIdstringrequired

idstringrequired

Request body

application/json

assigneeIdstring | nullrequired

Member to hold accountable. A registered agent id is a delegation instead — the agent lands on delegateId and a lane is dispatched, while the human assignee stays (PILE-417).

Responses

200

Issue assigned

issueIssuerequired

Show properties

idstringrequired

organizationIdstringrequired

externalRefstring | nullrequired

teamIdstringrequired

titlestringrequired

descriptionstring | nullrequired

statusstringrequired

Allowed:triagebacklogtodoin_progressdonecanceled

prioritystringrequired

Allowed:lowmediumhighurgent

resolutionstring | nullrequired

Allowed:duplicatenot_plannedintended_behaviornot_reproducibleobsoleteresolvedskippednull

resolutionReasonstring | nullrequired

parentIdstring | nullrequired

subIssueSortOrdernumber | nullrequired

estimatenumber | nullrequired

isDraftbooleanrequired

sensitivebooleanrequired

snoozedUntilstring | nullrequired

assigneeIdstring | nullrequired

delegateIdstring | nullrequired

stepKeystring | nullrequired

requiredbooleanrequired

ownerAgentstring | nullrequired

claimedBystring | nullrequired

claimedLeaseExpiresAtstring | nullrequired

claimEpochnumberrequired

projectIdstring | nullrequired

cycleIdstring | nullrequired

labelIdsstring[]required

numbernumber | nullrequired

identifierstring | nullrequired

repostring | nullrequired

branchstring | nullrequired

prUrlstring | nullrequired

prStatestring | nullrequired

prCheckStatestring | nullrequired

createdAtstringrequired

updatedAtstringrequired

subStepProgressobject | null

Show properties

totalintegerrequired

doneintegerrequired

blockedintegerrequired

ownerAgentstring | nullrequired

sessionobject

Show properties

idstringrequired

organizationIdstringrequired

issueIdstringrequired

agentIdstringrequired

providerstringrequired

actorIdstringrequired

actorTypestringrequired

Allowed:useragent

statusstringrequired

Allowed:createdrunningstalewaitingcompletedfailedcanceled

resultstring | nullrequired

urlstring | nullrequired

providerSessionIdstring | nullrequired

prUrlstring | nullrequired

prStatestring | nullrequired

branchstring | nullrequired

purposestring | null

secondaryReposstring | null

maxDurationMinutesinteger | null

effortstring | null

Allowed:lowmediumhighmaxnull

labelstring | null

resultSchemaobject | null

structuredResultany | null

resultSchemaErrorsstring[] | null

createdAtstringrequired

updatedAtstringrequired

lastProgressAtstring | null

lastStateHashstring | null

awaitingActivityIdstring | null

awaitingEscalatedAtstring | null

pausednumber

stepKeystring | null

planobject[] | null

Show properties

Array of object

contentstringrequired

min length 1 · max length 500

statusstringrequired

Allowed:pendinginProgresscompletedcanceled

guidanceobject[] | null

Show properties

Array of object

idstringrequired

namestringrequired

scopestringrequired

Allowed:workspaceteamstatusstep

scopeKeystring | nullrequired

versionintegerrequired

derivedStatusstring | null

Allowed:stalledneeds_inputnull

awaitingFirstAckboolean

firstActivityAtstring | null

queuedAfterstring | null

receiptobject | null

Show properties

idstringrequired

organizationIdstringrequired

sessionIdstringrequired

issueIdstringrequired

agentIdstringrequired

stepKeystring | nullrequired

dealIdstring | nullrequired

statusstringrequired

modelstring | nullrequired

effortstring | nullrequired

inputTokensinteger | nullrequired

outputTokensinteger | nullrequired

totalTokensinteger | nullrequired

toolCallsinteger | nullrequired

costMicrosinteger | nullrequired

externalSpendMicrosinteger | nullrequired

totalCostMicrosinteger | nullrequired

costSourcestring | nullrequired

Allowed:reportedrate_mapnull

capExceededintegerrequired

stopReasonstring | nullrequired

startedAtstring | nullrequired

endedAtstring | nullrequired

durationMsinteger | nullrequired

createdAtstringrequired

updatedAtstringrequired

activitiesobject[]

Show properties

Array of object

idstringrequired

sessionIdstringrequired

actorIdstring | nullrequired

typestringrequired

Allowed:thoughtresponseerrorelicitationpromptactionstatusartifact

messagestringrequired

payloadany | null

parentIdstring | nullrequired

startedAtstring | nullrequired

endedAtstring | nullrequired

durationMsnumber | nullrequired

createdAtstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

organizationIdpath*idpath*

Bodyapplication/json

assigneeIdstring*Member to hold accountable. A registered agent id is a delegation instead — the agent lands on delegateId and a lane is dispatched, while the human assignee stays (PILE-417).

Request

curl -X POST 'https://pile.nyc/workspaces/string/issues/string/assign' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "assigneeId": "string"
}'

const response = await fetch("https://pile.nyc/workspaces/string/issues/string/assign", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"assigneeId\": \"string\"\n}"
});

import requests

response = requests.post(
    "https://pile.nyc/workspaces/string/issues/string/assign",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"assigneeId\": \"string\"\n}",
)

Response

{
  "issue": {
    "id": "string",
    "organizationId": "string",
    "externalRef": "string",
    "teamId": "string",
    "title": "string",
    "description": "string",
    "status": "triage",
    "priority": "low",
    "resolution": "duplicate",
    "resolutionReason": "string",
    "parentId": "string",
    "subIssueSortOrder": 0,
    "estimate": 0,
    "isDraft": true,
    "sensitive": true,
    "snoozedUntil": "string",
    "assigneeId": "string",
    "delegateId": "string",
    "stepKey": "string",
    "required": true,
    "ownerAgent": "string",
    "claimedBy": "string",
    "claimedLeaseExpiresAt": "string",
    "claimEpoch": 0,
    "projectId": "string",
    "cycleId": "string",
    "labelIds": [
      "string"
    ],
    "number": 0,
    "identifier": "string",
    "repo": "string",
    "branch": "string",
    "prUrl": "string",
    "prState": "string",
    "prCheckState": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "subStepProgress": {
      "total": 0,
      "done": 0,
      "blocked": 0,
      "ownerAgent": "string"
    }
  },
  "session": {
    "id": "string",
    "organizationId": "string",
    "issueId": "string",
    "agentId": "string",
    "provider": "string",
    "actorId": "string",
    "actorType": "user",
    "status": "created",
    "result": "string",
    "url": "string",
    "providerSessionId": "string",
    "prUrl": "string",
    "prState": "string",
    "branch": "string",
    "purpose": "string",
    "secondaryRepos": "string",
    "maxDurationMinutes": 0,
    "effort": "low",
    "label": "string",
    "resultSchema": {
      "property1": null,
      "property2": null
    },
    "structuredResult": null,
    "resultSchemaErrors": [
      "string"
    ],
    "createdAt": "string",
    "updatedAt": "string",
    "lastProgressAt": "string",
    "lastStateHash": "string",
    "awaitingActivityId": "string",
    "awaitingEscalatedAt": "string",
    "paused": 0,
    "stepKey": "string",
    "plan": [
      {
        "content": "string",
        "status": "pending"
      }
    ],
    "guidance": [
      {
        "id": "string",
        "name": "string",
        "scope": "workspace",
        "scopeKey": "string",
        "version": 0
      }
    ],
    "derivedStatus": "stalled",
    "awaitingFirstAck": true,
    "firstActivityAt": "string",
    "queuedAfter": "string",
    "receipt": {
      "id": "string",
      "organizationId": "string",
      "sessionId": "string",
      "issueId": "string",
      "agentId": "string",
      "stepKey": "string",
      "dealId": "string",
      "status": "string",
      "model": "string",
      "effort": "string",
      "inputTokens": 0,
      "outputTokens": 0,
      "totalTokens": 0,
      "toolCalls": 0,
      "costMicros": 0,
      "externalSpendMicros": 0,
      "totalCostMicros": 0,
      "costSource": "reported",
      "capExceeded": 0,
      "stopReason": "string",
      "startedAt": "string",
      "endedAt": "string",
      "durationMs": 0,
      "createdAt": "string",
      "updatedAt": "string"
    },
    "activities": [
      {
        "id": "string",
        "sessionId": "string",
        "actorId": "string",
        "type": "thought",
        "message": "string",
        "payload": null,
        "parentId": "string",
        "startedAt": "string",
        "endedAt": "string",
        "durationMs": 0,
        "createdAt": "string"
      }
    ]
  }
}