Script

Plan an AI draft

Optional first step of an AI draft. Returns what the model understood (outline), up to 3 questions for the author with suggested answers, and the facts it needs. Agents that already send a complete intent skip it. To use it, pass the returned plan, your answers (by question id) and session_id to POST /projects/generate or POST /projects with intent. Always runs on the Quick model (~150-350 credits). Writes nothing.

post/v1/communities/{communityId}/projects/generate/plan

Request

  • Base URL: https://api.subo.ai
  • URL: https://api.subo.ai/v1/communities/{communityId}/projects/generate/plan
  • Auth: API key in header X-API-Key

Path parameters

communityIdstring required

Community ID (Discord guild snowflake, serialized as string)

Request body

intentstring required

The goal of the convo in plain language

question_countinteger

How many questions to draft (intro, content and action blocks not counted). Capped by the plan's limit. Omit to let the model choose what the goal needs.

languagestring

Language respondents will read: any language's name (French, Tagalog) or a locale code (fr, pt-BR, ja). Defaults to a language the intent names ("a poll in Tagalog"), else the community's. Only a value that is not a language name or code is a 400.

admin_languagestring

Language the plan and author_notes are written in for you (the author): any language's name or a locale code. It never sets the project's language. When omitted it is inferred from the intent, and the response's notices say so.

Example request

{
  "language": "fr",
  "admin_language": "en"
}

Response

The plan, the qualities you can afford, and the session to continue

Changes

No recorded changes to this operation across all 1 revision of this API.