> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humanos.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform DID Document

> No API key: any verifier fetches it  
The `did:web` document of the platform itself, with the key that signs mandates (STAMP) and platform events



## OpenAPI

````yaml /versions/2026-10-16.yaml get /.well-known/did.json
openapi: 3.1.0
info:
  title: Humanos API
  description: Humanos API
  version: '1.0'
  contact: {}
servers:
  - url: https://api.humanos.tech
security: []
tags:
  - name: humanosApp
    description: ''
paths:
  /.well-known/did.json:
    get:
      tags:
        - DID
      summary: Platform DID Document
      description: >-
        No API key: any verifier fetches it  

        The `did:web` document of the platform itself, with the key that signs
        mandates (STAMP) and platform events
      operationId: did_platformDidDocument
      parameters:
        - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Returns the platform's DID document.
          content:
            application/did+json:
              schema:
                $ref: '#/components/schemas/DidDocumentEntity'
components:
  parameters:
    ApiVersion:
      name: API-Version
      in: header
      required: false
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
        example: '2026-10-16'
      description: >-
        Pin request, response, and webhook shapes to a specific dated API
        version (YYYY-MM-DD). Omit to use the version pinned to your API key
        (set when the key is created; new keys default to the latest version).
        New integrations should target the latest version.
  schemas:
    DidDocumentEntity:
      type: object
      properties:
        '@context':
          description: >-
            JSON-LD contexts: the DID core v1 and Multikey contexts, plus
            `https://w3id.org/security/jwk/v1` when the document lists an agent
            key (`JsonWebKey` with `publicKeyJwk`), which the first two do not
            define.
          example:
            - https://www.w3.org/ns/did/v1
            - https://w3id.org/security/multikey/v1
          type: array
          items:
            type: string
        id:
          type: string
          description: The DID this document describes
          example: did:web:humanos.tech:org:550e8400-e29b-41d4-a716-446655440000
        verificationMethod:
          description: Verification methods declared for this DID
          type: array
          items:
            $ref: '#/components/schemas/VerificationMethodEntity'
        authentication:
          description: Verification method IDs authorized for authentication
          example:
            - >-
              did:web:humanos.tech:org:550e8400-e29b-41d4-a716-446655440000#key-1
          type: array
          items:
            type: string
        assertionMethod:
          description: Verification method IDs authorized for making assertions
          example:
            - >-
              did:web:humanos.tech:org:550e8400-e29b-41d4-a716-446655440000#key-1
          type: array
          items:
            type: string
      required:
        - '@context'
        - id
        - verificationMethod
    VerificationMethodEntity:
      type: object
      properties:
        id:
          type: string
          description: >-
            Verification method identifier (MUST be a URI, typically
            `<did>#<keyId>`)
          example: did:web:humanos.tech:org:550e8400-e29b-41d4-a716-446655440000#key-1
        type:
          type: string
          description: >-
            Verification method type: `Multikey` for Ed25519 organization and
            user keys, `JsonWebKey` for P-256 agent keys (W3C names).
          enum:
            - Multikey
            - JsonWebKey
          example: Multikey
        controller:
          type: string
          description: DID of the controller of this verification method
          example: did:web:humanos.tech:org:550e8400-e29b-41d4-a716-446655440000
        publicKeyMultibase:
          type: string
          description: >-
            Ed25519 public key as a multibase string. Present on organization
            and user keys; absent on agent keys, which are P-256 and carry
            `publicKeyJwk` instead.
          example: z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK
        publicKeyJwk:
          type: object
          description: >-
            P-256 public key as a JWK. Present on agent keys, whose v0.3 §16
            proof-of-possession is ES256; absent on organization and user keys,
            which are Ed25519 and carry `publicKeyMultibase`.
          example:
            kty: EC
            crv: P-256
            x: ...
            'y': ...
      required:
        - id
        - type
        - controller

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.