---
title: "Submit tool outputs."
method: POST
path: "/api/v1/projects/{projectId}/tasks/{taskId}/tool-outputs"
tags: ["Task Messages"]
---

# Submit tool outputs.

`POST /api/v1/projects/{projectId}/tasks/{taskId}/tool-outputs`

## Request

- Base URL: `https://app.customgpt.ai`
- URL: `https://app.customgpt.ai/api/v1/projects/{projectId}/tasks/{taskId}/tool-outputs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/poll-the-people/apis/customgpt-ai/docs/api/v1/projects/:projectId/tasks/:taskId/tool-outputs/post.ts> (a function with typed inputs; its response is checked against the schema)

Resumes a task paused on `awaiting_tool_results` by submitting the results of the
function calls requested by the agent. All pending `tool_call_id`s must be answered
in one request. Returns 202 Accepted; poll the task for progress — the agent may
request further function calls or complete with a final answer.

## Path parameters

- `projectId` integer, required
- `taskId` string, required

## Request body

- object
  - `tool_outputs` object[], required: One entry per pending tool call.
    - `tool_call_id` string, required: The `id` of the tool call being answered, as returned in `result.tool_calls`.
    - `output` string, required: The function result, serialized as a string (typically JSON).

## Response `202`

Task created and submitted successfully. Poll GET /tasks/{taskId} for progress.

- object
  - `status` 'error' | 'success': The status of the response
  - `data` Task
    - `id` string: Task ID
    - `project_id` integer: Agent ID this task belongs to
    - `name` string: Task name
    - `created_at` string, date-time: When the task was created
    - `updated_at` string, date-time: When the task was last updated

## Other responses

- `400`: Bad Argument
- `401`: API Token is either missing or invalid
- `402`: This feature is not available on your current plan. Upgrade your subscription or enable the required setting to use this endpoint.
- `404`: Agent not found
- `409`: Task is locked because a session is currently in progress. Retry after the active session completes.
- `422`: Unsupported Argument
- `429`: Resource Exhausted when sending a message to a conversation
- `500`: Internal Server Error

## Changes

- **2026-11-03** `77aab4354382`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/poll-the-people/apis/customgpt-ai/changes/api/v1/projects/:projectId/tasks/:taskId/tool-outputs/post.md)

---

[API](https://skmtc.dev/poll-the-people/apis/customgpt-ai.md) - [All operations](https://skmtc.dev/poll-the-people/apis/customgpt-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/poll-the-people/apis/customgpt-ai/revisions/77aab4354382?raw)