Affinda · Capability

Affinda Document Types API — Document Types

Affinda Document Types — list, create, update, delete document types and read their JSON Schema or Pydantic model representations.

Affinda Document Types API — Document Types is a Naftiko capability published by Affinda, one of 8 capabilities the APIs.io network indexes for this provider. It bundles 3 operations.

The capability includes 3 read-only operations. Lead operation: List Affinda document types. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Affinda and Document Types.

Run with Naftiko AffindaDocument Types

MCP Tools

affinda-list-document-types

List Affinda document types.

read-only idempotent
affinda-get-document-type

Get a document type by identifier.

read-only idempotent
affinda-get-document-type-json-schema

Retrieve the JSON Schema for a document type's parsed fields.

read-only idempotent

Capability Spec

document-types-document-types.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: Affinda Document Types API — Document Types
  description: Affinda Document Types — list, create, update, delete document types and read their JSON
    Schema or Pydantic model representations.
  tags:
  - Affinda
  - Document Types
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    AFFINDA_API_KEY: AFFINDA_API_KEY
capability:
  consumes:
  - type: http
    namespace: document-types
    baseUri: https://api.affinda.com
    description: Affinda v3 Document Types.
    resources:
    - name: v3-document-types
      path: /v3/document_types
      operations:
      - name: listdocumenttypes
        method: GET
        description: List document type configurations.
        outputRawFormat: json
        outputParameters: [{name: results, type: object, value: $.}]
        inputParameters: []
      - name: createdocumenttype
        method: POST
        description: Create a document type.
        outputRawFormat: json
        outputParameters: [{name: documentType, type: object, value: $.}]
        inputParameters:
        - {name: body, in: body, type: object, required: true}
    - name: v3-document-types-identifier
      path: /v3/document_types/{identifier}
      operations:
      - name: getdocumenttype
        method: GET
        description: Get a document type by identifier.
        outputRawFormat: json
        outputParameters: [{name: documentType, type: object, value: $.}]
        inputParameters:
        - {name: identifier, in: path, type: string, required: true}
      - name: updatedocumenttype
        method: PATCH
        description: Update a document type.
        outputRawFormat: json
        outputParameters: [{name: documentType, type: object, value: $.}]
        inputParameters:
        - {name: identifier, in: path, type: string, required: true}
        - {name: body, in: body, type: object, required: true}
    - name: v3-document-types-jsonschema
      path: /v3/document_types/{identifier}/json_schema
      operations:
      - name: getdocumenttypejsonschema
        method: GET
        description: Get the JSON Schema representation of a document type's fields.
        outputRawFormat: json
        outputParameters: [{name: schema, type: object, value: $.}]
        inputParameters:
        - {name: identifier, in: path, type: string, required: true}
    authentication:
      type: apikey
      key: Authorization
      value: 'Bearer {{env.AFFINDA_API_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: document-types-mcp
    port: 9090
    transport: http
    description: MCP adapter for Affinda Document Types.
    tools:
    - name: affinda-list-document-types
      description: List Affinda document types.
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: document-types.listdocumenttypes
      outputParameters: [{type: object, mapping: $.}]
    - name: affinda-get-document-type
      description: Get a document type by identifier.
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: document-types.getdocumenttype
      with: {identifier: tools.identifier}
      outputParameters: [{type: object, mapping: $.}]
    - name: affinda-get-document-type-json-schema
      description: Retrieve the JSON Schema for a document type's parsed fields.
      hints: {readOnly: true, destructive: false, idempotent: true}
      call: document-types.getdocumenttypejsonschema
      with: {identifier: tools.identifier}
      outputParameters: [{type: object, mapping: $.}]