Nash Annotate API

Annotate

Operations 2

POST /v1/flags Create Flag #
POST /v1/notes Create Note #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nash-annotate-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nash-annotate-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Nash AI Functions Annotate API
  version: 1.0.0
  description: LLM-backed domain tools
servers:
- url: https://api.sandbox.usenash.com
  description: Sandbox API
- url: https://api.sandbox.ap-southeast-2.usenash.com
  description: Sandbox API (Australia)
- url: https://api.usenash.com
  description: Production API
- url: https://api.ap-southeast-2.usenash.com
  description: Production API (Australia)
tags:
- name: Annotate
  description: Annotate
  x-nash-topic: wismo
paths:
  /v1/flags:
    post:
      tags:
      - Annotate
      summary: Create Flag
      description: Create a flag annotation on a delivery or job to mark it for attention or follow-up.
      operationId: create_flag_v1_flags_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFlagInputSerializer'
        required: true
      responses:
        '422':
          description: Unprocessable Content
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NashValidationError'
  /v1/notes:
    post:
      tags:
      - Annotate
      summary: Create Note
      description: Add a text note annotation to a delivery or job for internal record-keeping.
      operationId: create_note_v1_notes_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateNoteInputSerializer'
        required: true
      responses:
        '422':
          description: Unprocessable Content
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NashValidationError'
components:
  schemas:
    NashValidationError:
      title: NashValidationError
      required:
      - error
      - response_status
      - RequestID
      type: object
      properties:
        error:
          $ref: '#/components/schemas/NashErrorDetails'
        response_status:
          title: Response Status
          type: string
        RequestID:
          title: Requestid
          type: string
    NashErrorDetails:
      title: NashErrorDetails
      required:
      - code
      - message
      type: object
      properties:
        code:
          title: Code
          type: string
        message:
          title: Message
          type: string
        details:
          title: Details
          anyOf:
          - type: object
            additionalProperties: true
          - type: 'null'
          default: null
    CreateNoteInputSerializer:
      title: CreateNoteInputSerializer
      required:
      - jobId
      - note
      type: object
      properties:
        jobId:
          title: Jobid
          type: string
          description: The job ID to create a note for.
        taskId:
          title: Taskid
          anyOf:
          - type: string
          - type: 'null'
          description: The task ID to create a note for.
          default: null
        note:
          title: Note
          type: string
          description: The note to create.
      description: Expected payload for the create note endpoint.
    FlagStatus:
      title: FlagStatus
      enum:
      - NEEDS_ATTENTION
      - ACKNOWLEDGED
      - RESOLVED
      type: string
    CreateFlagInputSerializer:
      title: CreateFlagInputSerializer
      required:
      - notes
      type: object
      properties:
        jobId:
          title: Jobid
          anyOf:
          - type: string
          - type: 'null'
          description: The job ID to create a flag for.
          default: null
        taskId:
          title: Taskid
          anyOf:
          - type: string
          - type: 'null'
          description: The task ID to create a flag for.
          default: null
        orderId:
          title: Orderid
          anyOf:
          - type: string
          - type: 'null'
          description: The order ID to create a flag for.
          default: null
        deliveryId:
          title: Deliveryid
          anyOf:
          - type: string
          - type: 'null'
          description: The delivery ID to create a flag for.
          default: null
        status:
          $ref: '#/components/schemas/FlagStatus'
          description: The status of the flag.
          default: NEEDS_ATTENTION
        notes:
          title: Notes
          type: string
          description: The notes to create a flag for.
      description: Expected payload for the create flag endpoint.
  securitySchemes:
    Token:
      type: http
      scheme: bearer
      bearerFormat: JWT, API Key