Deliverd Decision Sessions API
The Decision Sessions API from Deliverd — 2 operation(s) for decision sessions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/deliverd-dev:deliverd-dev-decision-sessions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Deliverd Dev Decision Sessions API
version: 1.0.0
x-refined-note:
- x-source differs across the merged source definitions and was not carried
description: 'Operations tagged Decision Sessions across 2 of this provider''s published API definitions: deliverd-dev-openapi.json, deliverd-dev-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://deliverd.dev
description: 'Deliverd REST API (paths carry the /api/v1 prefix; https://deliverd.dev/llms.txt: "REST API: https://deliverd.dev/api/v1")'
tags:
- name: Decision Sessions
paths:
/api/v1/decision-sessions/{id}:
get:
summary: A decision session's state
description: '`open`, `verified` (the approver confirmed who they are), `complete` (they decided, here or anywhere else) or `expired`, with their decision and the request''s own status. Never the secret. Needs approvals:read.'
security:
- bearerAuth: []
parameters:
- schema:
type: string
format: uuid
required: true
name: id
in: path
responses:
'200':
description: The session
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
object:
type: string
enum:
- decision_session
approvalId:
type: string
format: uuid
approver:
type: object
properties:
type:
type: string
enum:
- member
- guest
email:
type: string
required:
- type
- email
mode:
type: string
enum:
- hosted
- embedded
origin:
type:
- string
- 'null'
returnUrl:
type:
- string
- 'null'
url:
type: string
description: Returned once, when the session is made.
clientSecret:
type: string
description: Returned once, when the session is made.
status:
type: string
enum:
- open
- verified
- complete
- expired
decision:
type:
- string
- 'null'
enum:
- approved
- rejected
- changes_requested
- null
approvalStatus:
type: string
enum:
- pending
- approved
- rejected
- changes_requested
- expired
- cancelled
expiresAt:
type: string
verifiedAt:
type:
- string
- 'null'
completedAt:
type:
- string
- 'null'
createdAt:
type: string
required:
- id
- object
- approvalId
- approver
- mode
- origin
- returnUrl
- status
- decision
- approvalStatus
- expiresAt
- verifiedAt
- completedAt
- createdAt
'404':
description: Not found
tags:
- Decision Sessions
operationId: getApiV1DecisionSessionsById
x-operation-id-source: derived
/api/v1/decision-sessions/{id}/expire:
post:
summary: End a decision session early
description: A decision already made through it stays made. Needs approvals:write.
security:
- bearerAuth: []
parameters:
- schema:
type: string
format: uuid
required: true
name: id
in: path
responses:
'200':
description: The session
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
object:
type: string
enum:
- decision_session
approvalId:
type: string
format: uuid
approver:
type: object
properties:
type:
type: string
enum:
- member
- guest
email:
type: string
required:
- type
- email
mode:
type: string
enum:
- hosted
- embedded
origin:
type:
- string
- 'null'
returnUrl:
type:
- string
- 'null'
url:
type: string
description: Returned once, when the session is made.
clientSecret:
type: string
description: Returned once, when the session is made.
status:
type: string
enum:
- open
- verified
- complete
- expired
decision:
type:
- string
- 'null'
enum:
- approved
- rejected
- changes_requested
- null
approvalStatus:
type: string
enum:
- pending
- approved
- rejected
- changes_requested
- expired
- cancelled
expiresAt:
type: string
verifiedAt:
type:
- string
- 'null'
completedAt:
type:
- string
- 'null'
createdAt:
type: string
required:
- id
- object
- approvalId
- approver
- mode
- origin
- returnUrl
- status
- decision
- approvalStatus
- expiresAt
- verifiedAt
- completedAt
- createdAt
'404':
description: Not found
tags:
- Decision Sessions
operationId: postApiV1DecisionSessionsByIdExpire
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'API key (dlv_…) created in Settings → API tokens, or an OAuth access token (dlvo_…). Every route below can answer `401 auth_error` — the credential was not accepted — or `403 insufficient_scope`, which is a different thing: the credential is fine and was not issued with the scope this route needs. Reissue it with that scope rather than replacing it with another of the same ones. Older clients may still branch on `auth_error` for both.'
x-refined-from:
- deliverd-dev-openapi.json
- deliverd-dev-openapi.yml