Tasks

The POST /tasks method creates a list of tasks.

post/v1/tasks

Request

  • Base URL
    https://api.linkup.so
  • URL
    https://api.linkup.so/v1/tasks
  • Auth
    HTTP bearer

Request body

Example request

[
  {
    "input": {
      "depth": "deep",
      "excludeDomains": [
        "wikipedia.org"
      ],
      "includeDomains": [
        "microsoft.com",
        "agolution.com"
      ],
      "outputType": "sourcedAnswer",
      "q": "What is Microsoft's 2024 revenue?"
    },
    "type": "search"
  },
  {
    "input": {
      "extractImages": false,
      "includeRawContent": false,
      "renderJs": false,
      "url": "https://docs.linkup.so"
    },
    "type": "fetch"
  },
  {
    "input": {
      "outputType": "sourcedAnswer",
      "q": "Research the current state of the semiconductor market, covering key market dynamics, major industry players and their strategic positioning, recent analyst sentiment, and the main bull and bear cases for the sector. Ground the report in sourced, factual information."
    },
    "type": "research"
  }
]

Response

Tasks created successfully.

Example response

[
  {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "id": "01234-abcd-56789",
    "status": "completed",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "input": {
      "excludeDomains": [
        "wikipedia.org"
      ],
      "fromDate": "2025-01-01",
      "includeDomains": [
        "microsoft.com",
        "agolution.com"
      ],
      "q": "What is Microsoft's 2024 revenue?",
      "toDate": "2025-01-01",
      "maxResults": 5
    },
    "output": {
      "answer": "Microsoft's revenue for fiscal year 2024 was $245.1 billion, reflecting a 16% increase from the previous year.",
      "sources": [
        {
          "name": "Microsoft 2024 Annual Report",
          "snippet": "Highlights from fiscal year 2024 compared with fiscal year 2023 included: Microsoft Cloud revenue increased 23% to $137.4 billion.",
          "url": "https://www.microsoft.com/investor/reports/ar24/index.html"
        }
      ]
    }
  }
]

Changes

    • breaking

      removed subschema #1 subschema #2 from the request property oneOf list

    • breaking

      added subschema #1 subschema #2 to the response property oneOf list for the response status

    • info

      added subschema #1 subschema #2 to the request property oneOf list

    • info

      removed subschema #1 subschema #2 from the response property oneOf list for the response status