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

# Create Task

> Create a new automated browser task

<RequestExample>
  ```bash theme={null}
  curl --request POST \
    --url 'http://localhost:2003/api/v1/task/create' \
    --header 'x-api-key: <your-api-key>' \
    --header 'Content-Type: application/json' \
    --data '{
      "task": "Monitor a website for price changes",
      "agent": "BROWSER_AGENT",
      "tools": [
        {
          "type": "function",
          "function": {
            "name": "form_input",
            "description": "Use this tool to ask information from the user",
            "parameters": {
              "type": "object",
              "properties": {
                "heading": {
                  "type": "string",
                  "description": "The heading of the form input"
                },
                "description": {
                  "type": "string",
                  "description": "The description of the form input"
                },
                "fields": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string",
                        "description": "Input field type"
                      },
                      "label": {
                        "type": "string",
                        "description": "Label text"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "taskId": "task_123"
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml POST /task/create
openapi: 3.1.0
info:
  title: Browserable API
  description: API for managing automated browser tasks
  version: 1.0.0
servers:
  - url: https://api.browserable.ai/api/v1/
    description: API Server
security:
  - apiKey: []
paths:
  /task/create:
    post:
      summary: Create Task
      description: Create a new automated browser task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - task
              properties:
                task:
                  type: string
                  description: Natural language description of the task to be automated
                  example: Monitor a website for price changes
                agent:
                  type: string
                  default: BROWSER_AGENT
                  description: Agent to use for the task
                tools:
                  type: array
                  description: List of tools available to the agent
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                        description: Type of tool. Only 'function' is supported currently.
                        example: function
                      function:
                        type: object
                        properties:
                          name:
                            type: string
                            description: Name of the function
                          description:
                            type: string
                            description: Description of what the function does
                          parameters:
                            type: object
                            description: JSON Schema of the function parameters
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Indicates if the request was successful
                    example: true
                  data:
                    type: object
                    properties:
                      taskId:
                        type: string
                        description: The ID of the created task
                        example: task_123
                  error:
                    type: string
                    description: Error message if the request failed
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````