Skip to main content

Update api-key

PUT 
/api/v1/partner/settings/api-keys/:id

Update an API key's name, scopes, full access, expiry, or webhook URL.

Request​

Path Parameters

    id int64required

    The unique identifier of the .

Body

    name (string | null)

    Possible values: non-empty

    full_access (boolean | null)
    allowed_routes string[]

    Possible values: non-empty

    Route ids (e.g. 'POST /api/v8/partner/documents') and/or preset tokens (e.g. 'preset:lens-sdk') this key may use; ignored when full_access is true. GET /api/v1/partner/settings/api-keys/available-permissions for the full list of valid values.

    manager_ids integer[]
    webhook_url uri

    Possible values: non-empty and <= 2083 characters

    HTTPS URL that receives webhooks triggered by requests made with this key. When set, it overrides the client-level webhook URL for those requests. Send null to clear it.

    expires_at date-time

Responses​

An API key

Schema
    id integerrequired
    name (string | null)

    Possible values: non-empty

    key (string | null)

    Possible values: non-empty

    full_access booleanrequired
    allowed_routes string[]required

    Possible values: non-empty

    status stringrequired

    Possible values: non-empty

    managers object[]
  • Array [
    • id integerrequired
    name stringrequired

    Possible values: non-empty

    email stringrequired

    Possible values: non-empty

    is_owner booleanrequired
    active booleanrequired
  • ]
    • webhook_url uri

    Possible values: non-empty and <= 2083 characters

    last_used_at date-time
    expires_at date-time
    created date-time
Loading...