Skip to main content
POST
Update an integration API key whose entire current and proposed project access is granted to this caller.
Update an integration API key whose entire current and proposed project access is granted to this caller. Requires a scoped personal key, an explicit granted project_id, and integration_keys.write. Current role and credential grants remain enforced. See Agent messaging and project operations for authorization and recovery.

Authorizations

Authorization
string
header
required

Integration key for backend workloads, or a scoped personal key (sr_user_) for account discovery and supported project operations. MCP accepts only personal keys.

Headers

X-Sendrealm-Project-Id
string<uuid>
required

Body

application/json
id
string<uuid>
required

Owned resource UUID from the matching list operation.

Required string length: 1 - 36
name
string

Display name.

Required string length: 1 - 120
project_scope
enum<string>

Project access scope. Personal-key callers can select only explicitly granted projects; all_projects requires a dashboard session.

Available options:
all_projects,
selected_projects
project_ids
string<uuid>[]

Explicit granted projects for a team key.

Maximum array length: 500

Owned resource UUID from the matching list operation.

Required string length: 1 - 36
permissions
enum<string>[]

Explicit integration-key permissions.

Required array length: 1 - 6 elements
Available options:
*,
email.send,
push.send,
events.ingest,
resources.read,
resources.write
default_project_id
string<uuid>

Owned resource UUID from the matching list operation.

Required string length: 1 - 36

Response

Authorized result, preparation, or durable execution receipt.

status
integer
required
data
object
required