The Containers Chat API manages conversations and messages for the Wix AI coding agent. Use this API to integrate the coding agent's chat experience into your app, allowing users to send requests, track the agent's progress, and read the full response.
With the Containers Chat API, you can:
When you call Send Message, two things happen immediately:
DONE status.WORKING status. This turn represents the agent's in-progress response.As the agent works, the assistant turn's tasks field is updated with a live checklist of work items. When the agent finishes, the turn transitions to DONE with the final response in its parts field. If the agent fails, the turn transitions to ERROR.
The API doesn't support real-time streaming. After calling Send Message, poll Query Messages to check the assistant turn's status. When the status changes from WORKING to DONE, the final response is available in the parts field.
It's important to note the following points before starting to code:
projectId to create a conversation.idempotencyKey. Use a unique key per user message and reuse the same key if retrying a failed request.role of USER or ASSISTANT and a status of WORKING, DONE, or ERROR.tasks field of the assistant message.Last updated: 3 August 2026