Get a message job by id

GET

/v1/telegram/messages/{id}

• Production

Returns the current state of a previously enqueued message job. Ownership is verified via the associated Telegram account - jobs belonging to other users return 404. Requires scope telegram:read.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

integer

Responses

200

Message job found.

Full message job detail returned by GET /v1/telegram/messages/{id}.

object

id

integer

accountId

integer

status

string

Allowed values: queued sent failed

runAt

string format: date-time

createdAt

string format: date-time

updatedAt

string format: date-time

nullable

lastError

Last error message if the job has failed.

string

nullable

401

Missing or invalid bearer token.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "unauthorized",
  "message": "Invalid bearer principal"
}

403

The API key does not have the required scope for this operation.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "forbidden",
  "message": "scope contacts:write is required"
}

404

The requested resource does not exist or is not owned by the caller.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "not_found",
  "message": "contact not found"
}

429

Per-key rate limit exceeded. Retry after the time indicated by X-RateLimit-Reset.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "rate_limited",
  "message": "rate limit exceeded"
}

Headers

X-RateLimit-Limit

integer

Maximum requests allowed per minute for this key.

X-RateLimit-Remaining

integer

Requests remaining in the current window.

X-RateLimit-Reset

integer

Unix timestamp (seconds) when the rate limit window resets.