Accounts

Issue a one-time Telegram connection command

Returns the signed command exactly once. It expires after 15 minutes and is never placed in a URL, job, log, or later response.

post/accounts/telegram/connection-code

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/accounts/telegram/connection-code
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Request body

$schemastring uri

A URL to the JSON Schema for this object.

expected_chat_idstring required

Canonical non-zero numeric Telegram chat ID that must redeem the command

workspace_idstring required

Workspace receiving the Telegram destination

Example request

{
  "$schema": "https://example.com/api/v1/schemas/IssueTelegramConnectionCodeInputBody.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

bot_usernamestring required

Instance-owned Telegram bot username

codestring required

One-time command to post in the destination chat. Returned only by this issuance response.

expires_atstring date-time required

When the one-time command expires

Example response

{
  "$schema": "https://example.com/api/v1/schemas/IssueTelegramConnectionCodeResponse.json"
}

Changes

No recorded changes to this operation across all 1 revision of this API.