Create Term Decision

POST /terms/{term_ref}/decisions

Creates a canonical decision for the current revision of the identified term.

Conventions

Authentication

All endpoints require a Bearer token. Pass it in the Authorization header as Bearer <token>. Tokens are issued from the API settings page in your workspace.

Base URL

All paths are relative to https://api.allsign.app. The spec includes full paths; strip the base when constructing requests.

Versioning

The current version is 0.1.0. Breaking changes are documented in the Changelog and announced before taking effect.

Specification

The API follows OpenAPI Specification 3.x. All documentation on this page is generated directly from the spec.

Example

Bash

curl "https://api.allsign.app/terms/{term_ref}/decisions" \
  -X POST \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "status": "accepted"
}'

Request

Request Path

term_ref

Public term reference.

stringrequired

Request Body

{
  "proposed_description": "",
  "proposed_name": "",
  "remarks": "",
  "status": "accepted",
  "supersedes_decision_ref": "00000000-0000-4000-8000-000000000000"
}

proposed_description

stringnulloptional

proposed_name

stringnulloptional

remarks

stringnulloptional

status

accepted | rejectedrequired

supersedes_decision_ref

stringnulloptional

Responses

201 Created

Decision created.

{
  "data": {
    "decision": {
      "actor": {},
      "created_at": "2026-01-01T00:00:00Z",
      "ref": "00000000-0000-4000-8000-000000000000",
      "remarks": "",
      "revision": {},
      "status": "accepted"
    },
    "proposal_decision": {},
    "revision": {}
  }
}

data

objectrequired

data.decision

Canonical decision resource.

objectrequired

data.decision.actor

objectrequired

data.decision.created_at

string (date-time)required

data.decision.ref

Public stable resource reference.

string (uuid)required

data.decision.remarks

stringnullrequired

data.decision.revision

objectrequired

data.decision.status

accepted | rejectedrequired

data.proposal_decision

objectrequired

data.revision

objectrequired

400 Bad Request

{
  "error": {
    "code": "",
    "message": "",
    "request_id": "",
    "status": 1
  }
}

error

objectrequired

error.code

stringrequired

error.message

stringrequired

error.request_id

stringrequired

error.status

integerrequired

error.fields

object[]optional

401 Unauthorized

{
  "error": {
    "code": "",
    "message": "",
    "request_id": "",
    "status": 1
  }
}

error

objectrequired

error.code

stringrequired

error.message

stringrequired

error.request_id

stringrequired

error.status

integerrequired

error.fields

object[]optional

404 Not Found

{
  "error": {
    "code": "",
    "message": "",
    "request_id": "",
    "status": 1
  }
}

error

objectrequired

error.code

stringrequired

error.message

stringrequired

error.request_id

stringrequired

error.status

integerrequired

error.fields

object[]optional

409 Conflict

{
  "error": {
    "code": "",
    "message": "",
    "request_id": "",
    "status": 1
  }
}

error

objectrequired

error.code

stringrequired

error.message

stringrequired

error.request_id

stringrequired

error.status

integerrequired

error.fields

object[]optional

422 Unprocessable Entity

{
  "error": {
    "code": "",
    "message": "",
    "request_id": "",
    "status": 1
  }
}

error

objectrequired

error.code

stringrequired

error.message

stringrequired

error.request_id

stringrequired

error.status

integerrequired

error.fields

object[]optional