---
title: "POST /agents/{agentId}/credentials"
method: POST
path: "/agents/{agentId}/credentials"
---

# POST /agents/{agentId}/credentials

`POST /agents/{agentId}/credentials`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/agents/{agentId}/credentials`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `agentId` union, required: Agent identifier
  - string
  - string

## Request body

- object: Input for issuing a verifiable credential to an agent (master key). Platform verification events (email OTP, phone provisioning, Stripe checkout) auto-issue AnimaEmailVerified/AnimaOwnerBound, AnimaPhoneVerified, and AnimaPaymentCapable; those types (plus AnimaKYBCompleted) derive the agent card's public verification.level and are platform-reserved — issuing them here returns 403. This endpoint issues the org-attestation types (AnimaAddressVerified, AnimaTrustScore), recorded with metadata.source=api, distinct from the platform's source=platform-auto.
  - `type` 'AnimaEmailVerified' | 'AnimaPhoneVerified' | 'AnimaAddressVerified' | 'AnimaKYBCompleted' | 'AnimaPaymentCapable' | 'AnimaOwnerBound' | 'AnimaTrustScore', required: Credential type to issue
  - `claims` object: Additional claims for the credential subject (the subject id is always the agent's DID)
  - `expiresInSeconds` integer: Optional credential lifetime in seconds (omit for non-expiring)

## Response `200`

OK

- object: A Verifiable Credential record
  - `id` string, required
  - `agentId` string, required
  - `orgId` string, required
  - `type` string, required
  - `jwtVc` string, required
  - `issuerDid` string, required
  - `subjectDid` string, required
  - `issuedAt` string, required
  - `expiresAt` string, nullable, required
  - `revoked` boolean, required
  - `revokedAt` string, nullable, required
  - `revocationIndex` number, nullable, required
  - `metadata` object, nullable, required
  - `createdAt` string, required
  - `updatedAt` string, required

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)