Prepare an IXO Topic for review.

A Topic is a shared place for a question, project or piece of work in Qi.Space. Use the Topic entry API to return a draft the person can review and import.

Draft, validate and hand back.

  1. Capture the person's intent

    Keep their exact words as the source intent. Show them any context you propose to include. Send only the intent and approved details needed for the draft; leave private conversation history out.

  2. Get the instructions for this draft

    Read the manifest for the current endpoints and schemas. Use recipe discovery to find a starting point. If the person selects a recipe, pass its returned recipeRef unchanged. Otherwise omit it to use the Base Recipe. Request the prompt with the verbatim sourceIntent string and the optional recipeRef.

  3. Validate the complete draft

    Use the returned prompt to prepare a TopicComposition that satisfies the linked schemas. Keep suggested content proposed. Leave unconfirmed identity, permissions and evidence out. Send the same intent and recipe reference, plus the draft as composition, to the validation endpoint. Fix any errors before handing it back.

  4. Return the JSON for import

    Give the person the complete JSON as a file or a single JSON block. Direct them to the Topic starter to review and import it. Stop at the draft. The person chooses whether to continue and create the Topic in Qi.Space.

Connect to another IXO service.

To use Asks, IXO Memory or a service that checks claims, choose the relevant plugin or hosted MCP connector. Topic drafting uses the manifest above.