Get brief
get_briefGet a brief's status and, once completed, its guidance and assets. Set wait to true to wait until it completes or fails, up to the timeout. If the result is still pending or processing, repeat the same call with wait: true. After the JSON, each image asset has a resource link to the same URL, followed by the image when it fits the size limit. Only the brief's creator can read it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"brief_id": "<brief_id>"
},
"name": "get_brief"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait while the brief is pending or processing, until it completes or fails or the timeout expires. Defaults to false. | |
| timeout | No | How long this read may wait, in seconds, including setup and polling. Applies when wait is true. Defaults to and is capped at 45 seconds. | |
| brief_id | Yes | ID of the Brief whose status, guidance, and assets to retrieve. Use brief_id returned by create_brief. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. | |
| inline_media | No | Set to false to get only the JSON and resource links, without images or audio, for example when re-reading a result you have already seen. Defaults to true, which adds images and audio after their links while the result stays within its size limit. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Failure details. Present once the brief failed. | |
| assets | No | Brand files selected for the task. Present once the brief completes. | |
| status | Yes | Current brief status. | |
| brief_id | Yes | Brief ID. Once the brief is completed, pass it as brief_id to generate_image or generate_video. | |
| guidance | No | Brand guidance for the task. Present once the brief completes. | |
| skill_id | Yes | ID of the Brand Skill version the brief used, or null once that version is deleted. | |
| failed_at | No | Time the brief failed. Present once failed. | |
| created_at | Yes | Time the brief was created. | |
| completed_at | No | Time the brief completed. Present once completed. | |
| message_for_assistant | No | Context, explanations, or actionable guidance for the calling assistant. Hosts may display it, but it is not copy that must be shown to the user verbatim. |