Manage Applications

    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": {}
         }'