Saltar al contenido principal
PATCH
/
v1
/
api_key
/
{id}
Update Api Key
import requests

url = "https://api.diga.io/v1/api_key/{id}"

payload = {
    "name": "<string>",
    "restricted": True,
    "permissions": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "created_date": "2023-11-07T05:31:56Z",
  "last_four_digits": "<string>",
  "creator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "restricted": true,
  "permissions": []
}

Autorizaciones

​
Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

​
id
string<uuid>
requerido

The ID of the API key to update

Cuerpo

application/json
​
name
string

Nuevo nombre de la API key

​
restricted
boolean

Indica si la API key es restringida o no.

​
permissions
enum<string>[] | null

Lista completa de permisos para reemplazar (solo keys restringidas).

App permissions.

Opciones disponibles:
companies.delete,
companies.update,
calls.create,
calls.delete,
calls.update,
calls.view,
messages.view,
agents.view,
agents.create,
agents.update,
agents.delete,
phones.view,
phones.purchase,
phones.delete,
phones.update,
phones.import,
tools.view,
tools.create,
tools.delete,
tools.update,
contacts.view,
contacts.delete,
conversational_paths.view,
conversational_paths.create,
conversational_paths.delete,
conversational_paths.update,
knowledge_bases.view,
knowledge_bases.create,
knowledge_bases.delete,
knowledge_bases.update,
webhooks.view,
webhooks.create,
webhooks.delete,
webhooks.update,
members.view,
members.create,
members.delete,
members.update,
billing.view,
billing.update,
api_keys.view,
api_keys.create,
api_keys.delete,
api_keys.update,
voices.view,
transcriptions.view,
recordings.view,
stats.view,
verifications.create,
verifications.view,
notifications.view,
notifications.update,
logs.view,
integrations.view,
integrations.create,
integrations.update,
integrations.delete,
workflows.view,
workflows.create,
workflows.update,
workflows.delete

Respuesta

Successful Response

​
id
string<uuid>
requerido

The unique identifier for the API key

​
name
string
requerido

The name of the API key

​
created_date
string<date-time>
requerido

The date and time when the API key was created

​
last_four_digits
string
requerido

The last four digits of the API key

​
creator_id
string<uuid>
requerido

The ID of the user who created the API key

​
restricted
boolean
requerido

Whether the API key is restricted to a set of specific permissions

​
permissions
enum<string>[] | null

The permissions associated with the API key

App permissions.

Opciones disponibles:
companies.delete,
companies.update,
calls.create,
calls.delete,
calls.update,
calls.view,
messages.view,
agents.view,
agents.create,
agents.update,
agents.delete,
phones.view,
phones.purchase,
phones.delete,
phones.update,
phones.import,
tools.view,
tools.create,
tools.delete,
tools.update,
contacts.view,
contacts.delete,
conversational_paths.view,
conversational_paths.create,
conversational_paths.delete,
conversational_paths.update,
knowledge_bases.view,
knowledge_bases.create,
knowledge_bases.delete,
knowledge_bases.update,
webhooks.view,
webhooks.create,
webhooks.delete,
webhooks.update,
members.view,
members.create,
members.delete,
members.update,
billing.view,
billing.update,
api_keys.view,
api_keys.create,
api_keys.delete,
api_keys.update,
voices.view,
transcriptions.view,
recordings.view,
stats.view,
verifications.create,
verifications.view,
notifications.view,
notifications.update,
logs.view,
integrations.view,
integrations.create,
integrations.update,
integrations.delete,
workflows.view,
workflows.create,
workflows.update,
workflows.delete