API conventions

Base URL

https://api.rcsstudio.ai

All endpoint paths are relative to this base URL.

Authentication

Every request requires an authentication header:

Authorization: Bearer <access_token>

See Authentication for how to obtain a token.

# Only updates defaultState — all other agent config fields are untouched
curl -X PATCH https://api.rcsstudio.ai/agents/ag_abc123 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"config": {"defaultState": "welcome"}}'

Phone numbers — E.164 format

All phone number fields use E.164 format: a + followed by the country code and number, no spaces or dashes.

Dates and timestamps — ISO 8601

All date and datetime fields use ISO 8601 format.

See also

• Authentication — How to obtain and refresh access tokens