---
title: "Update an API Credential"
method: PATCH
path: "/v1/organizations/{organizationId}/api-credentials/{apiCredentialId}"
tags: ["apiCredentials"]
---

# Update an API Credential

`PATCH /v1/organizations/{organizationId}/api-credentials/{apiCredentialId}`

Update the specified API Credential.

## Path parameters

- `organizationId` string, required
- `apiCredentialId` string, required

## Request body

- ApiCredentialUpdateRequestDTO
  - `name` string — Human-readable name of the API Credential.
  - `description` string — Brief description of the purpose and usage for the API Credential.
  - `enabled` boolean — If <code>true</code>, the API Credential is enabled. Otherwise, <code>false</code>.
  - `roles` ApiCredentialRolesSchema
    - `organizationRole` 'owner' | 'admin' | 'user', required — Organization-level Role assigned to the API Credential.
    - `workspaces` WorkspaceRoleSchema[] — Workspace-level Roles assigned to the API Credential.
      - `workspaceId` string, required — Unique ID of the Workspace.
      - `workspaceRole` 'owner' | 'admin' | 'user' | 'noaccess', required — Role assigned to the API Credential on the Workspace.
      - `products` ProductRoleSchema[] — Product-level Roles assigned to the API Credential for the Workspace.
        - `product` 'edge' | 'search' | 'stream' | 'lake' | 'insights', required — Product name.
        - `role` 'admin' | 'editor' | 'reader' | 'user' | 'noaccess', required — Role assigned to the API Credential on the product.
  - `ipAllowlist` string[] — Omit to leave unchanged. Pass an empty array to clear the stored IP allowlist.

## Response `204`

API Credential updated

## Other responses

- `404` — API Credential not found
- `409` — Could not update API Credential because the name is already in use
- `default` — Default error response

---

[API](https://skmtc.net/criblio/apis/cribl-cloud-public-api.md) · [All operations](https://skmtc.net/criblio/apis/cribl-cloud-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criblio/cribl-cloud-public-api/revisions/6b74b2f0e495/schema)