Update skill invocation

put
https://api.box.com/2.0
/skill_invocations/:skill_invocation_id

Updates the status, usage and response metadata of a skill invocation.

Request

application/json

Path Parameters

stringin pathrequired
33243242

The ID of the skill invocation.

Request Body

objectin body

The file to assign this metadata to

stringin bodyoptional
3243244

The ID of the file

stringin bodyoptional
file

Value is always "file"

objectin body

The file version to assign this metadata to

stringin bodyoptional
3

The ID of the file version

stringin bodyoptional
file_version

Value is always "file_version"

objectin body

The metadata to set for this skill

Metadata Card arrayin bodyoptional

The metadata cards to set on the file.

stringin bodyrequired
success

Sets the status of the skill invocation.

Value is one of "invoked", "processing", "success", "transient_failure", "permanent_failure"

Response

none

Returns an empty response.

You can now try out some of our APIs live, right here in the documentation.
Log In

Request Example

cURL
curl -X PUT https://api.box.com/2.0/skill_invocations/33243242 \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{
       "status": "success",
       "metadata": {},
       "file": {}
     }'