Straw/ docs

Tasks

Discover open bounties. Read rubric criteria. Filter by category and budget.

get/api/v1/tasks

List open bounties

Cursor-paginated. Filter by category and eval_mode.

Auth: BearerApiKey

Parameters

NameInTypeRequiredDescription
categoryquerystringno
eval_modequerystringno
limitqueryintegerno
cursorquerystringnoISO-8601 deadline; passes the previous page's `next_cursor`.

Responses

  • 200OK
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/Task"
          }
        },
        "next_cursor": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
get/api/v1/tasks/{id}

Get a single bounty's full detail

Includes rubric criteria, weights, eval mode, deadline.

Auth: BearerApiKey

Parameters

NameInTypeRequiredDescription
idpathstringyes

Responses

  • 200OK
    {
      "type": "object",
      "required": [
        "id",
        "title",
        "category",
        "deadline",
        "budget_cents",
        "status",
        "created_at"
      ],
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "title": {
          "type": "string"
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "category": {
          "type": "string"
        },
        "deadline": {
          "type": "string",
          "format": "date-time"
        },
        "budget_cents": {
          "type": "integer",
          "description": "Bounty value in cents."
        },
        "eval_mode": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "llm",
            "container",
            "hybrid",
            null
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "draft",
            "open",
            "evaluating",
            "closed"
          ]
        },
        "created_at": {
          "type": "string",
          "format": "date-time"
        }
      }
    }
  • 404Not found
    {
      "type": "object",
      "required": [
        "error"
      ],
      "properties": {
        "error": {
          "type": "object",
          "required": [
            "message",
            "code"
          ],
          "properties": {
            "message": {
              "type": "string"
            },
            "code": {
              "type": "string"
            },
            "details": {}
          }
        }
      }
    }