Skip to main content

Update an API key

PATCH 

/auth/api_keys/:id

Updates the specified API key with the values of the parameters passed. Any parameters not included in the request will be left unchanged.

Request

Path Parameters

    id stringrequired

    The id of the API Key

Body

required

    description string

    Human readable identifier.

    permission_groups string[]

    Array of ids of Permission Groups on the API Key.

    status string

    Status of the API Key.

Responses

200: Successful response

Schema

    data

    object

    id string

    uuid.

    description string

    Human readable identifier.

    secret string

    Secret used to authenticate API Key.

    backup_secret string

    Secondary secret which may also be used to authenticate API Key.

    status string

    Status of the API Key.

    permission_groups string[]

    Array of ids of Permission Groups on the API Key.

    admin boolean

    True if the API Key has admin rights, false otherwise.

    record_type string

    Record type.

    created_at string

    Timestamp of resource creation.

    updated_at string

    Timestamp of last resource update.

401: Authentication error

Schema

    errors

    object[]

  • Array [

  • code string

    an application-specific error code, expressed as a stringified integer.

    title string

    a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. Do not include punctuation in the title.

    detail string

    a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.

    pointer string

    JSON pointer to the field which is causing the error.

  • ]

403: Authorization error

Schema

    errors

    object[]

  • Array [

  • code string

    an application-specific error code, expressed as a stringified integer.

    title string

    a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. Do not include punctuation in the title.

    detail string

    a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.

    pointer string

    JSON pointer to the field which is causing the error.

  • ]

404: Resource not found

Schema

    errors

    object[]

  • Array [

  • code string

    an application-specific error code, expressed as a stringified integer.

    title string

    a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. Do not include punctuation in the title.

    detail string

    a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.

    pointer string

    JSON pointer to the field which is causing the error.

  • ]

422: Invalid parameters supplied in request. See HTTP response body for details.

Schema

    errors

    object[]

  • Array [

  • code string

    an application-specific error code, expressed as a stringified integer.

    title string

    a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. Do not include punctuation in the title.

    detail string

    a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.

    pointer string

    JSON pointer to the field which is causing the error.

  • ]

Loading...