> ## Documentation Index > Fetch the complete documentation index at: https://docs.answeringagent.com/llms.txt > Use this file to discover all available pages before exploring further. # Add a note to a task > Add an internal note to a conversation task, the same as typing a note on the task in the dashboard. Only your team sees it. Answering Agent does not contact the customer. The note's author is the key's creator. Form tasks take no notes. Each request adds a note, so sending the same request twice adds two. Requests from this playground go to production. Customer API. ## OpenAPI ````yaml /openapi.yaml post /tasks/{task_id}/notes openapi: 3.0.0 info: title: Answering Agent API description: > The Customer API reads a team's conversations, transcripts, recordings, tasks, contacts, and reports. It also updates tasks and adds notes to them. The Partner API lets reseller accounts manage organizations, users, locations, partner links, and embed tokens. Both use an X-API-KEY header. Requests from this playground go to production. version: 1.0.0 servers: - url: https://answeringagent.com/api/v1 description: Production security: [] tags: - name: Account description: Customer API. Your team, phone lines, and members. - name: Conversations description: >- Customer API. Calls, texts, website chats, and emails, with transcripts and recordings. - name: Tasks description: >- Customer API. Follow-up tasks. Read them, update their status or assignee, and add notes. - name: Contacts description: Customer API. Your customers. - name: Reports description: Customer API. Report metrics, totals, and breakdowns. - name: Organizations description: Partner API, reseller accounts only. - name: Users description: Partner API, reseller accounts only. - name: Locations description: Partner API, reseller accounts only. - name: Account Linking description: Partner API, reseller accounts only. - name: Embed Tokens description: Partner API, reseller accounts only. paths: /tasks/{task_id}/notes: post: tags: - Tasks summary: Add a note to a task description: > Add an internal note to a conversation task, the same as typing a note on the task in the dashboard. Only your team sees it. Answering Agent does not contact the customer. The note's author is the key's creator. Form tasks take no notes. Each request adds a note, so sending the same request twice adds two. Requests from this playground go to production. Customer API. operationId: addTaskNote parameters: - in: path name: task_id required: true schema: type: string pattern: ^conversation-\d+$ example: conversation-184532 description: >- A conversation task ID, such as conversation-184532. A form task ID returns 400. requestBody: required: true content: application/json: schema: type: object additionalProperties: false required: - content properties: content: type: string minLength: 1 maxLength: 5000 description: > The note text, 1 to 5,000 characters after leading and trailing spaces are removed. An @mention stays plain text and notifies nobody. example: content: >- Called Dana back. Membership cancelled in the POS before the charge on the 12th. responses: '201': description: The note was added. content: application/json: schema: $ref: '#/components/schemas/TaskNote' '400': $ref: '#/components/responses/CustomerBadRequest' '401': $ref: '#/components/responses/CustomerUnauthorized' '403': $ref: '#/components/responses/CustomerForbidden' '404': $ref: '#/components/responses/CustomerTaskNotFound' '405': $ref: '#/components/responses/CustomerMethodNotAllowed' '422': description: >- The dashboard would refuse the same note. The error gives the reason. content: application/json: schema: $ref: '#/components/schemas/CustomerError' '429': $ref: '#/components/responses/CustomerRateLimited' security: - ApiKeyAuth: [] components: schemas: TaskNote: type: object properties: id: type: integer example: 552190 content: type: string example: >- Called Dana back. Membership cancelled in the POS before the charge on the 12th. author: description: The key's creator. anyOf: - $ref: '#/components/schemas/Person' - $ref: '#/components/schemas/NullValue' created_at: type: string format: date-time nullable: true CustomerError: type: object required: - error - code properties: error: type: string description: A message for people. The text can change. example: That conversation is not available. code: type: string description: A stable code to branch on. enum: - invalid_request - unauthorized - forbidden - not_found - method_not_allowed - conflict - unprocessable - rate_limited - internal example: not_found issues: type: array description: >- Present when code is invalid_request. One entry for each input that failed validation. items: type: object properties: path: type: array items: {} message: type: string Person: type: object description: >- A team member. The id is what assigned_to and report filters.team_member_ids take. properties: id: type: integer example: 9034 name: type: string example: Priya Shah NullValue: description: No value. type: object nullable: true enum: - null responses: CustomerBadRequest: description: An input is missing or invalid. content: application/json: schema: $ref: '#/components/schemas/CustomerError' CustomerUnauthorized: description: >- The X-API-KEY header is missing, the key is wrong or revoked, or its owner was deactivated. content: application/json: schema: $ref: '#/components/schemas/CustomerError' CustomerForbidden: description: The key's owner is not an owner, admin, or manager on the team. content: application/json: schema: $ref: '#/components/schemas/CustomerError' CustomerTaskNotFound: description: > The task does not exist, or the key's owner cannot see it. For a task on a repeat conversation that was merged into an earlier one, the error names the task to use instead. content: application/json: schema: $ref: '#/components/schemas/CustomerError' example: error: >- This conversation was merged into conversation-184519. Use that task. code: not_found CustomerMethodNotAllowed: description: The endpoint does not support that HTTP method. Nothing changed. headers: Allow: description: The methods the endpoint supports, such as GET, HEAD, OPTIONS. schema: type: string content: application/json: schema: $ref: '#/components/schemas/CustomerError' example: error: This endpoint accepts GET. code: method_not_allowed CustomerRateLimited: description: More than 120 requests in a minute for this user. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/CustomerError' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.