API Reference

Assign Teams to a Chat

post
https://api.lodgestory.com/api/wp-crm/chat-assignments//teams/assign

Assign one or more teams to a chat.

  • Every member of each newly-assigned team is also assigned to the chat.
  • If the chat has no primary assignee yet, one is auto-selected via round-robin among the available team members.
  • A system message is posted to the chat thread.

Note: team membership is managed in your organisation settings; all current members of an assigned team are pulled into the chat.

Security:

  • The organisationId in the URL must match the organisation your JWT was issued for — requests for a different organisation fail with 401.
  • Requires CRM_ADMIN, ACCOUNT_OWNER, or CRM_BOT role; other roles receive 403.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Your organisation UUID (returned as org from the /token endpoint).

Body Params
string
required

The chat to assign teams to. Use the same chatId returned by POST /api/wp-crm/messaging/create-chat.

teamIds
array of strings
required

Team IDs to assign. Get these from GET /api/wp-crm/directory/:organisationId/teams. All team members are auto-assigned and, if the chat has no primary yet, one is auto-selected via round-robin among available members. Max 20.

teamIds*
Responses

400

Bad request — invalid body or a team is not in your organisation

401

Unauthorized

403

Forbidden — role not permitted

404

Chat not found in your organisation

429

Too many requests

500

Internal server error

Updated about 1 month ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago