---
title: "Promote Did"
method: POST
path: "/api/v1/did/{did_uri}/promote"
tags: ["did"]
---

# Promote Did

`POST /api/v1/did/{did_uri}/promote`

## Request

- Base URL: `https://agentavow.com` (the document declares no server; this is the origin it was published from)
- URL: `https://agentavow.com/api/v1/did/{did_uri}/promote`
- Auth: HTTP bearer

Promote a PROVISIONAL DID to FULL status. Admin only.

The did_uri path parameter should be a DID:web identifier, e.g.
``did:web:agentgraph.co:agents:<uuid>``.

## Path parameters

- `did_uri` string, required

## Headers

- `x-api-key` string, nullable

## Request body

- PromoteDIDRequest
  - `reason` string: Reason for promoting the DID to FULL status.

## Response `200`

Successful Response

- PromoteDIDResponse
  - `did_uri` string, required
  - `old_status` string, required
  - `new_status` string, required
  - `promotion_reason` string, required
  - `promoted_at` string, date-time, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

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