channels

Rename or rotate credentials (rotation re-runs registration) [write]

Changed on
patch/channels/apps/{id}

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/channels/apps/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The channel app id

Request body

retry_registrationboolean

Retry saved X verification without resubmitting credentials; mutually exclusive with credentials

labelstring
credentialsobject

Full replacement bag; rotation re-runs the platform registration

Response

OK

verification_errorstring

Non-secret explanation when X verification remains pending

verification_retryableboolean

Present for pending X verification. False means the saved refresh attempt cannot be replayed; replace credentials with a fresh OAuth grant.

idstring
platform'telegram' | 'slack' | 'discord' | 'whatsapp' | 'imessage' | 'email' | 'teams' | 'x' | 'lark' | 'buzz' | 'gchat' | 'line'
labelstring
statusstring
credential_keysstring[]

Key names only — values are write-only

created_atstring date-time
setupobject

Steps the platform cannot automate (per-app webhook_url / verify_token / events_url / invite_url)

Changes