CorefinityCorefinityDocs
Open the Control PanelControl Panel
Platform tools · 1 of 4

Get a command

Answers a command's status and result. Read it until status is succeeded, failed, timed_out or lost; a secret is never part of it.

GET/api/corestack/commands/{command}

Path parameters

commandintegerRequired

The id of a command, from a run. Digits only. At least 1.

Returns

200 The command.

Fields of the 200 answer
blocked_until_verifiedboolean
duration_msinteger or null
errorstring or nullRequired
exit_codeinteger or null
finished_atstring or nullRequired

Format: date-time.

idintegerRequired

At least 1.

inputany

The inputs the run was given. Never a secret.

kindstringRequired

The key of what ran, such as flush_cache.

labelstringRequired
operation_idinteger or null
output_excerptstring or null
queued_atstring or nullRequired

Format: date-time.

requested_byobject or any or null
resultanyRequired

What the run answered, by tool.

siteobjectRequired

A site by its id and domain.

Fields
domainstringRequired
idintegerRequired
started_atstring or nullRequired

Format: date-time.

statusstringRequired

succeeded, failed, timed_out and lost are final.

queuedrunningsucceededfailedtimed_outlost
status_labelstringRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404feature_offThis feature is not on for your organisation yet.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/corestack/commands/5120 \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "blocked_until_verified": false,
  "duration_ms": 840,
  "error": null,
  "exit_code": 0,
  "finished_at": "2026-11-19T09:30:01Z",
  "id": 5120,
  "input": null,
  "kind": "flush_cache",
  "label": "Flush cache",
  "operation_id": null,
  "output_excerpt": "Success: The cache was flushed.\n",
  "queued_at": "2026-11-19T09:30:00Z",
  "requested_by": {
    "id": 2012,
    "name": "Daniel Reyes"
  },
  "result": {
    "flushed": true
  },
  "site": {
    "domain": "journal.harbourandfinch.example.com",
    "id": 1051
  },
  "started_at": "2026-11-19T09:30:00Z",
  "status": "succeeded",
  "status_label": "Done"
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT