> Source: https://vitna.ai/docs/api/v1/engine/org-artifact-requests
> Raw Markdown: https://vitna.ai/docs/api/v1/engine/org-artifact-requests.md
> Corpus index: https://vitna.ai/llms.txt
# Headless artifact signing requests
Queue an asynchronous request for the isolated signer to rebuild and Ed25519-sign your organisation's standing routing policy or environment config, and poll until the artifact settles.
```
GET /api/v1/org/artifact-requests
POST /api/v1/org/artifact-requests
GET /api/v1/org/artifact-requests/{id}
```
```
Authorization: Bearer vitna_push_...
```
```bash
curl -X POST https://vitna.ai/api/v1/org/artifact-requests \
-H "authorization: Bearer vitna_push_..." \
-H "content-type: application/json" \
-d '{
"kind": "policy",
"decisionId": 18,
"requestedBy": "github-actions/deploy-routing"
}'
curl -H "authorization: Bearer vitna_push_..." \
https://vitna.ai/api/v1/org/artifact-requests/7
```
## Ask-only security boundary
Reads (`GET`) accept either a `platform` or `push` key. Queueing an ask (`POST`) requires a `platform` key (`vitna_key_...`) and answers `202` when accepted onto `aperture.artifact_request`.
A signing request names only `kind` (`policy` or `config`) and an optional `decisionId` ("as of this accepted decision"). It never accepts document bytes: supplying `body`, `bytes`, `document`, `policy`, `config` or `signature` answers `400 bytes_forbidden`, so the isolated `vitna_signer` daemon rebuilds every signed artifact from accepted decisions in the database rather than acting as a signing oracle.
At most one `pending` request sits on the queue per organisation at a time (`409 already_pending` returns the existing `pollUrl`). Once `state` moves to `signed`, fetch the canonical signed bytes from `artifact.body` (`/api/v1/artifacts/{id}`).
## Response shape
```json
{
"orgId": "convexity",
"request": {
"id": 7,
"orgId": "convexity",
"kind": "policy",
"decisionId": 18,
"requestedBy": "api-key:4 (github-actions/deploy-routing)",
"state": "signed",
"createdAt": "2026-09-14T18:30:00.000Z",
"settledAt": "2026-09-14T18:30:04.000Z",
"pollUrl": "/api/v1/org/artifact-requests/7",
"artifact": {
"id": 12,
"kind": "policy",
"outcome": "signed",
"at": "2026-09-14T18:30:04.000Z",
"digest": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"decisions": [18],
"publicKey": "MCowBQYDK2VwAyEA...",
"refusedBecause": null,
"body": "/api/v1/artifacts/12"
}
},
"meta": {
"generatedAt": "2026-09-14T18:30:05.000Z"
}
}
```