> ## Documentation Index
> Fetch the complete documentation index at: https://platform.autumn.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Start from task spec and stream

> Start directly from a known task spec and stream live server-sent events for the current turn.



## OpenAPI

````yaml /openapi.json post /task/start/stream
openapi: 3.1.0
info:
  title: Autumn Task API
  version: 1.0.0
  description: >-
    Start, stream, continue, execute, return to plan, and read sandboxed Autumn
    tasks. The public API surface is /task.
servers:
  - url: https://api.autumn.ai
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - name: POST
    x-group: POST
  - name: GET
    x-group: GET
paths:
  /task/start/stream:
    post:
      tags:
        - POST
      summary: Start from task spec and stream
      description: >-
        Start directly from a known task spec and stream live server-sent events
        for the current turn.
      operationId: taskStartDirectStream
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectTaskRequest'
            example:
              task:
                brief: Find 10 Series A AI security companies in the US.
                output:
                  id: ai-security-companies
                  kind: research
                  path: outputs/ai-security-companies.jsonl
                  target_count: 10
                  schema:
                    company_name: string
                    website: string
                    funding_stage: string
                    source_urls: array[string]
                  schema_order:
                    - company_name
                    - website
                    - funding_stage
                    - source_urls
      responses:
        '200':
          description: SSE stream of task, tool, text, error, and done events.
          content:
            text/event-stream:
              schema:
                type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/OutOfCredits'
components:
  schemas:
    DirectTaskRequest:
      type: object
      properties:
        task:
          type: object
          additionalProperties: true
          description: >-
            task.json-style spec with brief, one optional output, skills, rules,
            and input files.
        brief:
          type: string
          nullable: true
          description: Convenience field for direct starts without nesting task.
        prompt:
          type: string
          nullable: true
          description: >-
            Optional instruction appended to the task brief, or used as the task
            brief when task is omitted.
        clarify:
          type: boolean
          nullable: true
          description: >-
            Only affects starts that plan (a prompt or bare brief). If true, the
            agent may ask one blocking planning question before work begins; if
            false (default) it plans autonomously and starts executing. Has no
            effect when a full task spec is provided: that executes directly.
        output:
          type: object
          nullable: true
          additionalProperties: true
          description: >-
            Optional single output hint. Include id, kind, path, name, and, for
            research outputs, schema, schema_order, and target_count.
        version:
          type: string
          enum:
            - ranger
            - scout
          description: >-
            Model tier for the task. ranger (default) is the most capable model
            with the deepest reasoning; scout is faster on a tuned harness. Set
            at start only and fixed for the life of the task.
          example: scout
      additionalProperties: true
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        detail:
          type: string
      additionalProperties: true
  responses:
    BadRequest:
      description: The request body was invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    OutOfCredits:
      description: The account is out of credits.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Autumn API key
      description: 'Use `Authorization: Bearer YOUR_AUTUMN_API_KEY`.'
      x-default: YOUR_AUTUMN_API_KEY
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Alternate API-key header. Use the same Autumn API key.
      x-default: YOUR_AUTUMN_API_KEY

````