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

# Submit Template for Review

> Submit a draft template for admin review

# Submit Template for Review

Submit a draft template for admin approval. After submission, the template enters `pending_approval` status.

## Endpoint

```
POST /templates/{template_id}/submit
```

## Path Parameters

| Parameter     | Type   | Required | Description     |
| ------------- | ------ | -------- | --------------- |
| `template_id` | string | Yes      | The template ID |

## Request

```bash theme={null}
curl -X POST https://api.docyard.io/v1/templates/tmpl-ins-dec-001/submit \
  -H "X-API-Key: dk_live_dist_aaaaaaaa" \
  -H "X-API-Secret: dk_secret_dist_bbbbbbbb"
```

## Response

```json theme={null}
{
  "template_id": "tmpl-ins-dec-001",
  "status": "pending_approval",
  "submitted_at": "2026-03-15T10:00:00Z",
  "message": "Template submitted for review. You will be notified once approved."
}
```

## Error Responses

### Invalid Status (409)

```json theme={null}
{
  "error": "invalid_status",
  "message": "Template cannot be submitted",
  "details": {
    "current_status": "pending_approval",
    "required_status": "draft"
  }
}
```

### Not Found (404)

```json theme={null}
{
  "error": "not_found",
  "message": "Template not found"
}
```

***

## Related Endpoints

* [Create Template](/api-reference/artifact-types/create)
* [Get Template](/api-reference/artifact-types/get)