Answer a run that stopped to ask something

A money tool can stop a run to ask a question — which recipient, confirm this transfer — and the run blocks until it is answered. The answer goes back over the runtime’s api-key surface, which the caller must never hold, so it is proxied here. No deployment segment in the path: the grant names the deployment.

POST /connect/interact/user-action/{userActionId}/{action}

Answer a run that stopped to ask something

cURL

curl --request POST \
  --url https://api.paygent.payman.ai/connect/interact/user-action/{userActionId}/{action} \
  --header 'Content-Type: application/json' \
  --header 'x-paygent-connect-app-key: <api-key>' \
  --header 'x-paygent-connect-grant: <api-key>' \
  --data '{}'

200

{
  "success": true,
  "message": "<string>"
}

Authorizations

x-paygent-connect-app-key · string · header · required

A Connect app key (pgc_app_…), identifying the registered third-party app. Always presented together with connectGrant — the pair is one credential, and either half alone is refused. Accepted on the /connect/* surface only.

x-paygent-connect-grant · string · header · required

A Connect grant token (pgc_grant_…): one user's consent for the presenting app to reach one deployment. Every failure mode — missing, malformed, revoked, expired, or paired with the wrong app key — answers the same 401 invalid_connect_credentials.

Path Parameters

userActionId · string · required

The runtime's id for the pending action. Opaque to this server.

Maximum string length: 256

action · enum<string> · required

Available options: submit, cancel, expired, resend

Body

application/json

The answer, for submit. Ignored by the other three.

The body is of type object.

Response

200

application/json

The runtime accepted it

success · boolean · required

message · string · required