Upload Briefing Form

Upload a DOCX/PDF file, parse it, and store as a composable BriefForm.

Also creates a SpaceFile for R2 file storage (backward compat). Returns legacy BriefingFormResponse format for existing frontend.

POST /api/v1/teams/{team_id}/briefing-forms

Upload Briefing Form

cURL

curl --request POST \
  --url https://api.example.com/api/v1/teams/{team_id}/briefing-forms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=<string>'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "questions": [
    {
      "question_text": "<string>",
      "question_type": "textarea",
      "order": 0,
      "placeholder": "",
      "options": [
        "<string>"
      ]
    }
  ],
  "source_filename": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "is_default": false
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

team_id · string<uuid> · required

Body

multipart/form-data

file · string · required

Response

200

application/json

Successful Response

id · string<uuid> · required

name · string · required

questions · BriefingFormQuestionSchema · object[] · required

Show child attributes

source_filename · string · required

created_at · string<date-time> · required

is_default · boolean · default: false