Regenerate an A2A channel API key. Returns the new plaintext key exactly once and invalidates the previous key.

POST

/v1/apps/{app_id}/a2a-channels/{channel_id}/regenerate-key

• Production API

Parameters

Path Parameters

app_id

required

string

App ID

channel_id

required

string

A2A channel ID

Responses

200

API key rotated. The api_key field is the new plaintext key returned exactly once; the previous key is invalidated immediately.

Output of [RegenerateA2aApiKeyCmd] — includes the newly generated plaintext API key (returned once, never persisted) plus the updated [AppChannel].

object

api_key

required

New plaintext API key. Persist this — it cannot be recovered later. The previous key is invalidated immediately.

string

channel

required

The updated A2A channel.

object

channel_config

Channel-specific configuration (validated per channel type).

channel_type

required

Channel type (e.g. slack).

string

Allowed values: slack ag_ui schedule webhook a2a

created_at

required

Timestamp when this channel was created.

string format: date-time

enabled

Whether this channel is enabled.

boolean

id

required

External identifier (appchan_<32-hex>). Shown as “id” in API.

string

Example

appchan_01933b5a000070008000000000000001

updated_at

required

Timestamp when this channel was last updated.

string format: date-time

400

Invalid app/channel ID or channel is not an A2A channel

Standard error response for API endpoints.

object

error

required

Error message describing what went wrong.

string

401

Unauthorized

Standard error response for API endpoints.

object

error

required

Error message describing what went wrong.

string

403

Forbidden

Standard error response for API endpoints.

object

error

required

Error message describing what went wrong.

string

404

App or A2A channel not found

Standard error response for API endpoints.

object

error

required

Error message describing what went wrong.

string