A fully managed platform in Microsoft Foundry for hosting, scaling, and securing AI agents built with any supported framework or model
The error indicates that the workflow failed when trying to create an item in an existing conversation via the Foundry Conversations API.
To troubleshoot, validate each of the following against the workflow configuration and the API contract:
- Verify the conversation ID
- Ensure
conversation_id(conv_719a6b12d5ab869a00AY5r6HNCOrLq2SEp7g2dSu8GW9V8Ygjfin the error) actually exists by calling:-
GET {endpoint}/openai/v1/conversations/{conversation_id}
-
- If this call does not return HTTP 200 with an
OpenAI.ConversationResource, recreate the conversation first using:-
POST {endpoint}/openai/v1/conversations
-
- Ensure
- Check the item creation call
- The workflow step that adds to the conversation must call:
-
POST {endpoint}/openai/v1/conversations/{conversation_id}/items
-
- Required body:
{ "items": [ { /* OpenAI.InputItem */ } ] } - Confirm:
-
itemsis present and is a non‑empty array. - Each element matches the
OpenAI.InputItemschema expected by the Foundry project (correct fields, types, and item role/type).
-
- The workflow step that adds to the conversation must call:
- Confirm endpoint and project
- For Foundry projects, the endpoint must be of the form:
-
https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}
-
- Ensure the workflow is using the same project endpoint for:
- Creating the conversation.
- Creating conversation items.
- Listing/retrieving items.
- For Foundry projects, the endpoint must be of the form:
- Validate query parameters
- If the workflow passes
includeor other query parameters, temporarily remove them and test with the minimal valid call:-
POST {endpoint}/openai/v1/conversations/{conversation_id}/itemswith only the requireditemsbody.
-
- For listing or debugging items, use:
-
GET {endpoint}/openai/v1/conversations/{conversation_id}/items?limit=20&order=desc
-
- If the workflow passes
- Inspect API error details
- The workflow error shows
details:"", which means the workflow did not surface the underlying API error. - Run the same request outside the workflow (e.g., via a REST client) and check the full JSON error from the API (HTTP
defaultresponse withApiErrorResponseor genericobject). - Use the
apim-request-idheader from the failed call for deeper troubleshooting if needed.
- The workflow error shows
- Recreate the conversation if corrupted
- If item creation consistently fails on this conversation but works on a new one:
- Create a new conversation with
POST /openai/v1/conversations. - Point the workflow to the new
conversation_id.
- Create a new conversation with
- If item creation consistently fails on this conversation but works on a new one:
If, after these checks, item creation still fails, capture:
- The exact HTTP request (method, URL, headers, and body) used to create the item.
- The full API response body and status code.
Then compare them against the documented
Create conversation itemsandGet/List conversation itemsoperations to identify any schema or parameter mismatch.
References: