Forms

GET /api/v2/form/

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "uuid",
      "title": "Customer feedback",
      "slug": "a1b2c3d4e5f6",
      "is_active": true,
      "has_published_version": true,
      "is_accepting_responses": true,
      "created": "2026-01-15T08:00:00Z",
      "modified": "2026-03-15T14:30:00Z"
    }
  ]
}

POST /api/v2/form/

{
  "title": "Product survey"
}

GET /api/v2/form/{slug}/

{
  "id": "uuid",
  "title": "Product survey",
  "slug": "a1b2c3d4e5f6",
  "theme": { "id": "uuid", "name": "Default", ... },
  "published_version": 3,
  "is_active": true,
  "is_accepting_responses": true,
  "response_limit": null,
  "total_sessions": 142,
  "created": "2026-01-15T08:00:00Z",
  "modified": "2026-03-15T14:30:00Z"
}

PATCH /api/v2/form/{slug}/

{
  "title": "Updated title",
  "is_accepting_responses": false,
  "response_limit": 500
}

DELETE /api/v2/form/{slug}/

PUT /api/v2/form/{slug}/draft/

{
  "title": "Customer feedback",
  "graph": {
    "schema_version": "2.0",
    "entry_node_id": "node_welcome",
    "fallback_end_node_id": "node_end",
    "nodes": [
      {
        "id": "node_welcome",
        "question_type": "welcome_screen",
        "data": {
          "title": "Welcome!",
          "description": "This takes 2 minutes.",
          "is_required": false,
          "config": {}
        }
      },
      {
        "id": "node_q1",
        "question_type": "short_text",
        "data": {
          "title": "What is your name?",
          "is_required": true,
          "config": { "max_length": 100 }
        }
      },
      {
        "id": "node_end",
        "question_type": "end_screen",
        "data": {
          "title": "Thank you!",
          "is_required": false,
          "config": {}
        }
      }
    ],
    "edges": [
      { "from": "node_welcome", "to": "node_q1", "condition": null },
      { "from": "node_q1", "to": "node_end", "condition": null }
    ]
  }
}

{
  "graph": { ... },
  "last_saved_at": "2026-03-17T10:05:30Z"
}

POST /api/v2/form/{slug}/publish/

{
  "version_number": 4,
  "published_at": "2026-03-17T10:10:00Z"
}

GET /api/v2/form/{slug}/versions/

{
  "count": 4,
  "results": [
    {
      "id": "uuid",
      "version_number": 4,
      "status": "published",
      "is_valid": true,
      "published_at": "2026-03-17T10:10:00Z",
      "node_count": 8,
      "edge_count": 7,
      "is_current": true
    }
  ]
}

GET /api/v2/form/{slug}/versions/{version_number}/