meta {
  name: Create Topic
  type: http
  seq: 2
}

post {
  url: {{appview_url}}/api/topics
}

headers {
  Content-Type: application/json
}

body:json {
  {
    "title": "My new topic title",
    "text": "My new topic",
    "boardUri": "at://{{forum_did}}/space.atbb.forum.board/{{board_rkey}}"
  }
}

assert {
  res.status: eq 201
  res.body.uri: isDefined
  res.body.cid: isDefined
}

docs {
  Creates a new topic (thread starter post) in a board.

  Requires authentication via session cookie.

  Body parameters:
  - title: string (required) - Topic title (max 120 graphemes; required)
  - text: string (required) - Topic text content (1-3000 chars, max 300 graphemes)
  - boardUri: string (required) - AT URI of the board (at://did/space.atbb.forum.board/rkey)

  Returns:
  {
    "uri": "at://did:plc:user/space.atbb.post/rkey",
    "cid": "bafyrei...",
    "rkey": "3k..."
  }

  The post record written to PDS includes:
  - title (topic title)
  - forum reference (singleton, auto-configured)
  - board reference (from boardUri parameter)

  Error codes:
  - 400: Invalid input (missing or empty title, missing text, invalid boardUri, malformed JSON)
  - 401: Unauthorized (not authenticated)
  - 403: Forbidden (user is banned from this forum)
  - 404: Board not found
  - 503: Unable to reach PDS or database (temporary, retry later)
  - 500: Server error
}