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.

Path Parameters

id stringrequired

The id of the API Key

application/json

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.

200: Successful response

application/json

• Schema
• Example (from schema)

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.

{
  "data": {
    "id": "f30e7596-586e-44e1-ae7d-53db10f144d3",
    "description": "Tommy's Key",
    "secret": "XXXXXXXXXXXXX",
    "backup_secret": "XXXXXXXXXXXXX",
    "status": "active",
    "permission_groups": [
      "string"
    ],
    "admin": true,
    "record_type": "api_key",
    "created_at": "2018-02-08T18:49:22.998023Z",
    "updated_at": "2018-02-08T18:49:22.998023Z"
  }
}

401: Authentication error

application/json

• Schema
• Example (from schema)

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.

]

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

403: Authorization error

application/json

• Schema
• Example (from schema)

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.

]

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

404: Resource not found

application/json

• Schema
• Example (from schema)

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.

]

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

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

application/json

• Schema
• Example (from schema)

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.

]

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

Request samples

• cURL

---

curl -L -X PATCH 'https://api.telnyx.com/auth/api_keys/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "description": "Tommy'\''s Key",
  "permission_groups": [
    "string"
  ],
  "status": "active"
}'

Response samples

• 200
• 401
• 403
• 404
• 422

---

{
  "data": {
    "id": "f30e7596-586e-44e1-ae7d-53db10f144d3",
    "description": "Tommy's Key",
    "secret": "XXXXXXXXXXXXX",
    "backup_secret": "XXXXXXXXXXXXX",
    "status": "active",
    "permission_groups": [
      "string"
    ],
    "admin": true,
    "record_type": "api_key",
    "created_at": "2018-02-08T18:49:22.998023Z",
    "updated_at": "2018-02-08T18:49:22.998023Z"
  }
}

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}