Skip to main content
PATCH
/
api
/
v1
/
orgs
/
current
/
service-keys
/
{api_key_id}
Error
A valid request URL is required to generate request examples
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "short_key": "<string>",
  "description": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "read_only": false,
  "last_used_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "workspace_names": [
    "<string>"
  ],
  "default_workspace_name": "<string>",
  "role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "org_role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Documentation Index

Fetch the complete documentation index at: https://docs.langchain.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
api_key_id
string<uuid>
required

Body

application/json

API key PATCH schema.

role_id: New workspace-level role to apply to every workspace identity attached to the key. Optional; omit to leave workspace roles unchanged. org_role_id: New org-level role to apply to the key's org identity. Only valid for org-scoped keys (workspaces=None at creation). Optional.

​
role_id
string<uuid> | null
​
org_role_id
string<uuid> | null

Response

Successful Response

API key GET schema.

role_id, org_role_id, and access_scope let clients render the key's current role state without a second round trip. For workspace-scoped keys, org_role_id is null (the api_key's identity_id points at a workspace identity, so there is no caller-meaningful org role to surface).

​
id
string<uuid>
required
​
short_key
string
required
​
description
string
required
​
created_at
string<date-time> | null
​
read_only
boolean
default:false
deprecated
​
last_used_at
string<date-time> | null
​
expires_at
string<date-time> | null
​
workspace_names
string[] | null
​
default_workspace_name
string | null
​
role_id
string<uuid> | null
​
org_role_id
string<uuid> | null
​
access_scope
enum<string> | null
Available options:
organization,
workspace