Identifiers
IDs are readable strings that include the website they belong to. A well-formed ID grants nothing: every call is authorized against the caller’s current grants.
| Prefix | Resource | Format | Example |
|---|---|---|---|
web_ |
Website | web_{cluster_code}_{website_id} |
web_4927_123 |
con_ |
Conversation | con_{cluster_code}_{website_id}_{id} |
con_4927_123_456 |
msg_ |
Message | msg_{cluster_code}_{website_id}_{id} |
msg_4927_123_789 |
vis_ |
Visitor | vis_{cluster_code}_{website_id}_{id} |
vis_4927_123_42 |
ctc_ |
Contact | ctc_{cluster_code}_{website_id}_{id} |
ctc_4927_123_11 |
fil_ |
File | fil_{cluster_code}_{website_id}_{id} |
fil_4927_123_77 |
aif_ |
AI feature | aif_{cluster_code}_{website_id}_{id} |
aif_4927_123_3 |
chn_ |
Channel | chn_{cluster_code}_{website_id}_{id} |
chn_4927_123_2 |
team_ |
Team | team_{cluster_code}_{website_id}_{id} |
team_4927_123_5 |
opr_ |
Operator | Starts with opr_ |
|
sub_ |
Event subscription | sub_ and 32 hex characters |
|
evt_ |
Event receipt | evt_ and 64 hex characters |
|
op_ |
Write receipt | op_ and 64 hex characters |
- Collection operations need an explicit
website_id. There is no default website. - A resource ID already identifies its website. If you also send
website_id, it must match. - A resource you aren’t allowed to see returns
404, the same as one that doesn’t exist. - Treat IDs as opaque strings in storage. Don’t build them yourself from native INSIDE numbers.