Copilot

Stage an action proposal for the coach to approve

Ask Luca's own call. It stores a plan of catalog operations with a card, a diff, and side effects. Nothing runs until the coach confirms. Only a copilot turn on this thread may call it, and a retry within the turn returns the first proposal.

Session-only. This endpoint isn't on the API-key allowlist. An organization API key gets a 403 here, whatever scopes it holds.

post/api/copilot/threads/{threadId}/actions

Request

  • Base URL: https://api.setluca.com
  • URL: https://api.setluca.com/api/copilot/threads/{threadId}/actions
  • Auth: API key in cookie luca.session_token

Path parameters

threadIdstring uuid required

Identifier of the thread this operation targets.

Headers

Luca-API-Version'1'

The major version of the API this client was built against. Omit it and the request is served by the current major version. Any other value is refused with 400 unsupported_api_version.

Request body

sideEffectsstring[]
clientKeystring

Response

ok

idstring uuid required
threadIdstring uuid required
operationIdstring nullable required
planKindstring nullable required
revisioninteger required
payloadHashstring nullable required
sideEffectsstring[] required
statusstring required
expiresAtstring required
stuckboolean required

The run ended short, failed, or stopped showing progress, so the coach may retry or discard it.

toolNamestring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.