{
"openapi": "3.0.0",
"info": {
"title": "Catalyst Gateway",
"description": "# Catalyst Gateway API.\n\nThe Catalyst Gateway API provides realtime data for all prior, current and future Catalyst Voices voting events.",
"version": "1.2.0",
"termsOfService": "https://github.com/input-output-hk/catalyst-voices/blob/main/CODE_OF_CONDUCT.md",
"contact": {
"name": "Project Catalyst Team",
"url": "https://projectcatalyst.io",
"email": "contact@projectcatalyst.io"
},
"license": {
"name": "Apache 2.0",
"url": "https://www.apache.org/licenses/LICENSE-2.0"
}
},
"servers": [
{
"url": "http://buildkitsandbox:8080",
"description": "Server at localhost name."
}
],
"tags": [
{
"name": "Cardano",
"description": "General Cardano Blockchain Information."
},
{
"name": "Config",
"description": "Service Configuration and Status."
},
{
"name": "Documents",
"description": "Signed Document endpoints"
},
{
"name": "Health",
"description": "Service Health and Readiness."
}
],
"paths": {
"/api/v1/health/started": {
"get": {
"tags": [
"Health"
],
"summary": "Service Started",
"description": "This endpoint is used to determine if the service has started properly\nand is able to serve requests.\n\n## Note\n\n*This endpoint is for internal use of the service deployment infrastructure.\nIt may not be exposed publicly.*",
"responses": {
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"204": {
"description": "## No Content\n\nService is Started and can serve requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"NoAuthorization": []
}
],
"operationId": "healthStarted"
}
},
"/api/v1/health/ready": {
"get": {
"tags": [
"Health"
],
"summary": "Service Ready",
"description": "This endpoint is used to determine if the service is ready and able to serve\nrequests.\n\n## Note\n\n*This endpoint is for internal use of the service deployment infrastructure.\nIt may not be exposed publicly.*",
"responses": {
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"204": {
"description": "## No Content\n\nService is Started and can serve requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"NoAuthorization": []
}
],
"operationId": "healthReady"
}
},
"/api/v1/health/live": {
"get": {
"tags": [
"Health"
],
"summary": "Service Live",
"description": "This endpoint is used to determine if the service is live.\n\n## Note\n\n*This endpoint is for internal use of the service deployment infrastructure.\nIt may not be exposed publicly. Refer to []*",
"responses": {
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"204": {
"description": "## No Content\n\nService is OK and can keep running.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"NoAuthorization": []
}
],
"operationId": "healthLive"
}
},
"/api/v1/health/inspection": {
"put": {
"tags": [
"Health"
],
"summary": "Service Inspection Control.",
"description": "This endpoint is used to control internal service inspection features.\n\n## Note\n\n*This endpoint is for internal use of the service deployment infrastructure.\nIt may not be exposed publicly.*",
"parameters": [
{
"name": "log_level",
"schema": {
"$ref": "#/components/schemas/LogLevel"
},
"in": "query",
"description": "The log level to use for the service. Controls what detail gets logged.",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "query_inspection",
"schema": {
"$ref": "#/components/schemas/DeepQueryInspectionFlag"
},
"in": "query",
"description": "Enable or disable Verbose Query inspection in the logs. Used to find query\nperformance issues.",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"204": {
"description": "## No Content\n\nService is Started and can serve requests.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"NoAuthorization": []
}
],
"operationId": "healthInspection"
}
},
"/api/draft/rbac/chain_root/{stake_address}": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get RBAC chain root",
"description": "This endpoint returns the RBAC certificate chain root for a given stake address.",
"parameters": [
{
"name": "stake_address",
"schema": {
"type": "string",
"format": "cardano:cip19-address",
"title": "Cardano stake address",
"description": "Cardano stake address, also known as a reward address.",
"externalDocs": {
"url": "https://cips.cardano.org/cip/CIP-19",
"description": "CIP-19 - Cardano Addresses"
},
"example": "stake_test1uqehkck0lajq8gr28t9uxnuvgcqrc6070x3k9r8048z8y5gssrtvn",
"maxLength": 64,
"minLength": 59,
"pattern": "(stake|stake_test)1[a,c-h,j-n,p-z,0,2-9]{53}"
},
"in": "path",
"description": "Stake address to get the chain root for.",
"required": true,
"deprecated": false,
"explode": true
}
],
"responses": {
"200": {
"description": "## Ok\n\nSuccess returns the chain root hash.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ChainRootGetResponse"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"404": {
"description": "## Not Found\n\nNo chain root found for the given stake address.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "rbacChainRootGet"
}
},
"/api/draft/rbac/registrations/{catalyst_id}": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get registrations by Catalyst short ID.",
"description": "This endpoint returns RBAC registrations for the given Catalyst short identifier.",
"parameters": [
{
"name": "catalyst_id",
"schema": {
"type": "string",
"format": "catalyst_id",
"title": "Catalyst short ID",
"description": "Catalyst short identifier in string format",
"example": "preprod.cardano/11qYAYKxCrfVS_7TyWQHOg7hcvPapiMlrwIaaPcHURo",
"pattern": ".+\\..+\\/[A-Za-z0-9_-]{43}"
},
"in": "path",
"description": "A Catalyst short ID to get the registrations for.",
"required": true,
"deprecated": false,
"explode": true
}
],
"responses": {
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "## Ok\n\nSuccess returns a list of registration transaction ids.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/RbacRegistrationsResponse"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "rbacRegistrations"
}
},
"/api/draft/rbac/role0_chain_root/{role0_key}": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get RBAC chain root for a given role0 key.",
"description": "This endpoint returns the RBAC certificate chain root for a given role 0 key.",
"parameters": [
{
"name": "role0_key",
"schema": {
"type": "string",
"title": "Cardano 128-bit Hash",
"description": "Cardano Blake2b128 hash encoded in hex.",
"example": "0xdb50b8a1d4c03b18d41a8e98a6a18aed",
"maxLength": 34,
"minLength": 34,
"pattern": "^0x[0-9a-f]{32}$"
},
"in": "path",
"description": "Role0 key to get the chain root for.",
"required": true,
"deprecated": false,
"explode": true
}
],
"responses": {
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "## Ok\n\nSuccess returns the chain root hash.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/RbacRole0ChainRootResponse"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "rbacRole0KeyChainRoot"
}
},
"/api/v1/cardano/assets/{stake_address}": {
"get": {
"tags": [
"Cardano"
],
"summary": "Get staked assets.",
"description": "This endpoint returns the total Cardano's staked assets to the corresponded\nuser's stake address.",
"parameters": [
{
"name": "stake_address",
"schema": {
"type": "string",
"format": "cardano:cip19-address",
"title": "Cardano stake address",
"description": "Cardano stake address, also known as a reward address.",
"externalDocs": {
"url": "https://cips.cardano.org/cip/CIP-19",
"description": "CIP-19 - Cardano Addresses"
},
"example": "stake_test1uqehkck0lajq8gr28t9uxnuvgcqrc6070x3k9r8048z8y5gssrtvn",
"maxLength": 64,
"minLength": 59,
"pattern": "(stake|stake_test)1[a,c-h,j-n,p-z,0,2-9]{53}"
},
"in": "path",
"description": "The stake address of the user.\nShould be a valid Bech32 encoded address followed by the https://cips.cardano.org/cip/CIP-19/#stake-addresses.",
"required": true,
"deprecated": false,
"explode": true
},
{
"name": "network",
"schema": {
"$ref": "#/components/schemas/Network"
},
"in": "query",
"description": "Cardano network type.\nIf omitted network type is identified from the stake address.\nIf specified it must be correspondent to the network type encoded in the stake\naddress.\nAs `preprod` and `preview` network types in the stake address encoded as a\n`testnet`, to specify `preprod` or `preview` network type use this\nquery parameter.",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "asat",
"schema": {
"type": "string",
"format": "slot or time",
"title": "As At this Time OR Slot.",
"description": "Restrict the query to this time.\nTime can be represented as either the blockchains slot number, \nor the number of seconds since midnight 1970, UTC.\n\nIf this parameter is not defined, the query will retrieve data up to the current time.",
"example": "TIME:1730861339",
"maxLength": 25,
"minLength": 6,
"pattern": "^(SLOT|TIME):(\\d{1,20})$"
},
"in": "query",
"description": "A time point at which the assets should be calculated.\nIf omitted latest slot number is used.",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"404": {
"description": "## Not Found\n\nThe queried stake address was not found at the requested slot number.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "## Ok\n\nThe amount of ADA staked by the queried stake address, as at the indicated slot.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FullStakeInfo"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "stakedAssetsGet"
}
},
"/api/v1/cardano/registration/cip36": {
"get": {
"tags": [
"Cardano"
],
"summary": "CIP36 registrations.",
"description": "This endpoint gets the latest registration given either the voting key, stake\naddress, stake public key or the auth token.\n\nRegistration can be the latest to date, or at a particular date-time or slot\nnumber.",
"parameters": [
{
"name": "lookup",
"schema": {
"type": "string",
"format": "cardano:cip19-address|hex:ed25519-public-key",
"title": "Stake Address or Voting Key.",
"description": "Restrict the query to this Stake address, or Voters Public Key.\nIf neither are defined, the stake address(es) from the auth tokens role0 registration are used.",
"example": "stake_test1uqehkck0lajq8gr28t9uxnuvgcqrc6070x3k9r8048z8y5gssrtvn",
"maxLength": 66,
"minLength": 59,
"pattern": "^((stake|stake_test)1[a,c-h,j-n,p-z,0,2-9]{53})|(0x[A-Fa-f0-9]{64})$"
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "asat",
"schema": {
"type": "string",
"format": "slot or time",
"title": "As At this Time OR Slot.",
"description": "Restrict the query to this time.\nTime can be represented as either the blockchains slot number, \nor the number of seconds since midnight 1970, UTC.\n\nIf this parameter is not defined, the query will retrieve data up to the current time.",
"example": "TIME:1730861339",
"maxLength": 25,
"minLength": 6,
"pattern": "^(SLOT|TIME):(\\d{1,20})$"
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "page",
"schema": {
"type": "integer",
"format": "u32",
"title": "Page",
"description": "The page number of the data.\nThe size of each page, and its offset within the complete data set is determined by the `limit` parameter.",
"default": 0,
"example": 5,
"maximum": 4294967295.0,
"minimum": 0.0
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "limit",
"schema": {
"type": "integer",
"format": "u32",
"title": "Limit",
"description": "The size `limit` of each `page` of results.\nDetermines the maximum amount of data that can be returned in a valid response.\n\nThis `limit` of records of data will always be returned unless there is less data to return \nthan allowed for by the `limit` and `page`.\n\n*Exceeding the `page`/`limit` of all available records will not return `404`, it will return an \nempty response.*",
"default": 100,
"example": 10,
"maximum": 100.0,
"minimum": 1.0
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"404": {
"description": "No valid registration.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "All CIP36 registrations associated with the same Voting Key.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Cip36RegistrationList"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"422": {
"description": "Response for unprocessable content.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Cip36RegistrationUnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"NoAuthorization": []
}
],
"operationId": "cardanoRegistrationCip36"
}
},
"/api/draft/config/frontend": {
"get": {
"tags": [
"Config"
],
"summary": "Get the configuration for the frontend.",
"description": "Get the frontend configuration for the requesting client.\n\n### Security\n\nDoes not require any Catalyst RBAC Token to access.",
"responses": {
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "Configuration result.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FrontendConfig"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "get_config_frontend"
},
"put": {
"tags": [
"Config"
],
"summary": "Set the frontend configuration.",
"description": "Store the given config as either global front end configuration, or configuration\nfor a client at a specific IP address.\n\n### Security\n\nRequires Admin Authoritative RBAC Token.",
"parameters": [
{
"name": "IP",
"schema": {
"title": "IP Address.",
"oneOf": [
{
"type": "string",
"format": "ipv4"
},
{
"type": "string",
"format": "ipv6"
}
],
"example": "192.168.10.15"
},
"in": "query",
"description": "*OPTIONAL* The IP Address to set the configuration for.",
"required": false,
"deprecated": false,
"explode": true
}
],
"requestBody": {
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FrontendConfig"
}
}
},
"required": true
},
"responses": {
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"204": {
"description": "Configuration Update Successful.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"422": {
"description": "Set configuration unprocessable content.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ConfigUnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
}
],
"operationId": "put_config_frontend"
}
},
"/api/draft/config/frontend/schema": {
"get": {
"tags": [
"Config"
],
"summary": "Get the frontend configuration JSON schema.",
"description": "Returns the JSON schema which defines the data which can be read or written for\nthe frontend configuration.\n\n### Security\n\nDoes not require any Catalyst RBAC Token to access.",
"responses": {
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "Configuration result.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/FrontendConfig"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
},
{
"NoAuthorization": []
}
],
"operationId": "get_config_frontend_schema"
}
},
"/api/v1/document/{document_id}": {
"get": {
"tags": [
"Documents"
],
"summary": "Get A Signed Document.",
"description": "This endpoint returns either a specific or latest version of a registered signed\ndocument.",
"parameters": [
{
"name": "document_id",
"schema": {
"type": "string",
"format": "uuidv7",
"title": "UUIDv7",
"description": "128 Bit UUID Version 7 - Timestamp + Random",
"example": "01943a32-9f35-7a14-b364-36ad693465e6",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"in": "path",
"description": "UUIDv7 Document ID to retrieve",
"required": true,
"deprecated": false,
"explode": true
},
{
"name": "version",
"schema": {
"type": "string",
"format": "uuidv7",
"title": "UUIDv7",
"description": "128 Bit UUID Version 7 - Timestamp + Random",
"example": "01943a32-9f35-7a14-b364-36ad693465e6",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"in": "query",
"description": "UUIDv7 Version of the Document to retrieve, if omitted, returns the latest\nversion.",
"required": false,
"deprecated": false,
"explode": true
}
],
"responses": {
"404": {
"description": "## Not Found\n\nThe document could not be found.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"200": {
"description": "## OK\n\nThe Document that was requested.",
"content": {
"application/cbor": {
"schema": {
"type": "string",
"format": "binary",
"example": "(binary data)"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
}
],
"operationId": "getDocument"
}
},
"/api/v1/document": {
"put": {
"tags": [
"Documents"
],
"summary": "Put A Signed Document.",
"description": "This endpoint returns OK if the document is valid, able to be put by the\nsubmitter, and if it already exists, is identical to the existing document.",
"requestBody": {
"description": "The document to PUT",
"content": {
"application/cbor": {
"schema": {
"type": "string",
"format": "binary",
"example": "(binary data)"
}
}
},
"required": true
},
"responses": {
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"422": {
"description": "## Unprocessable Content\n\nError Response. The document submitted is invalid.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PutDocumentUnprocessableContent"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"413": {
"description": "## Content Too Large\n\nPayload Too Large. The document exceeds the maximum size of a legitimate single\ndocument.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"201": {
"description": "## Created\n\nThe Document was stored OK for the first time.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"204": {
"description": "## No Content\n\nThe Document was already stored, and has not changed.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
}
],
"operationId": "putDocument"
}
},
"/api/v1/document/index": {
"post": {
"tags": [
"Documents"
],
"summary": "Post A Signed Document Index Query.",
"description": "This endpoint produces a summary of signed documents that meet the criteria\ndefined in the request body.\n\nIt does not return the actual documents, just an index of the document identifiers\nwhich allows the documents to be retrieved by the `GET document` endpoint.",
"parameters": [
{
"name": "page",
"schema": {
"type": "integer",
"format": "u32",
"title": "Page",
"description": "The page number of the data.\nThe size of each page, and its offset within the complete data set is determined by the `limit` parameter.",
"default": 0,
"example": 5,
"maximum": 4294967295.0,
"minimum": 0.0
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
},
{
"name": "limit",
"schema": {
"type": "integer",
"format": "u32",
"title": "Limit",
"description": "The size `limit` of each `page` of results.\nDetermines the maximum amount of data that can be returned in a valid response.\n\nThis `limit` of records of data will always be returned unless there is less data to return \nthan allowed for by the `limit` and `page`.\n\n*Exceeding the `page`/`limit` of all available records will not return `404`, it will return an \nempty response.*",
"default": 100,
"example": 10,
"maximum": 100.0,
"minimum": 1.0
},
"in": "query",
"required": false,
"deprecated": false,
"explode": true
}
],
"requestBody": {
"description": "The Query Filter Specification",
"content": {
"application/json; charset=utf-8": {
"schema": {
"title": "Document Index Query Filter",
"description": "A Query Filter which causes documents whose metadata matches the provided\nfields to be returned in the index list response.\n\nFields which are not set, are not used to filter documents based on those metadata\nfields. This is equivalent to returning documents where those metadata fields either\ndo not exist, or do exist, but have any value.",
"allOf": [
{
"$ref": "#/components/schemas/DocumentIndexQueryFilter"
},
{
"title": "Document Index Query Filter",
"description": "A Query Filter which causes documents whose metadata matches the provided\nfields to be returned in the index list response.\n\nFields which are not set, are not used to filter documents based on those metadata\nfields. This is equivalent to returning documents where those metadata fields either\ndo not exist, or do exist, but have any value.",
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"ref": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"reply": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"template": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"ref": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"reply": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"template": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
}
},
"required": true
},
"responses": {
"400": {
"description": "## Bad Request\n\nThe client has not sent valid request, could be an invalid HTTP in general or\nprovided not correct headers, path or query arguments.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"412": {
"description": "## Precondition Failed\n\nThe client has not sent valid data in its request, headers, parameters or body.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/PreconditionFailed"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"401": {
"description": "## Unauthorized\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"503": {
"description": "## Service Unavailable\n\nThe service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/ServiceUnavailable"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RETRY-AFTER": {
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"200": {
"description": "## OK\n\nThe Index of documents which match the query filter.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"title": "Document Index List",
"description": "A list of all matching documents, limited by the paging parameters.\nDocuments are listed in Ascending order.\nThe Paging limit refers to the number fo document versions, not the number\nof unique Document IDs.",
"allOf": [
{
"$ref": "#/components/schemas/DocumentIndexList"
},
{
"title": "Document Index List",
"description": "A list of all matching documents, limited by the paging parameters.\nDocuments are listed in Ascending order.\nThe Paging limit refers to the number fo document versions, not the number\nof unique Document IDs.",
"example": {
"docs": [
{
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
],
"page": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
}
],
"example": {
"docs": [
{
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
],
"page": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"414": {
"description": "## URI Too Long\n\nThe client sent a request with the URI is longer than the server is willing to\ninterpret",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"429": {
"description": "## Too Many Requests\n\nThe client has sent too many requests in a given amount of time.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/TooManyRequests"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
},
"RETRY-AFTER": {
"required": true,
"deprecated": false,
"schema": {
"type": "string",
"format": "http-date || integer",
"title": "Retry-After Header",
"description": "Http Date or Interval in seconds.\nValid formats:\n\n* `Retry-After: <http-date>`\n* `Retry-After: <delay-seconds>`\n\nSee: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After>",
"example": "300"
}
}
}
},
"431": {
"description": "## Request Header Fields Too Large\n\nThe client sent a request with too large header fields.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"500": {
"description": "## Internal Server Error.\n\nAn internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/InternalServerError"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
}
}
},
"403": {
"description": "## Forbidden\n\nThe client has not sent valid authentication credentials for the requested\nresource.",
"content": {
"application/json; charset=utf-8": {
"schema": {
"$ref": "#/components/schemas/Forbidden"
}
}
},
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
},
"404": {
"description": "## Not Found\n\nNo documents were found which match the query filter.",
"headers": {
"Access-Control-Allow-Origin": {
"description": "Access-Control-Allow-Origin Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "origin",
"title": "Access-Control-Allow-Origin header.",
"description": "Valid formats:\n\n* `Access-Control-Allow-Origin: *`\n* `Access-Control-Allow-Origin: <origin>`\n* `Access-Control-Allow-Origin: null`\n",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin",
"description": "MDB Web Docs - Access-Control-Allow-Origin"
},
"example": "*"
}
},
"RateLimit": {
"description": "RateLimit Header.",
"deprecated": false,
"schema": {
"type": "string",
"format": "rate-limit",
"title": "RateLimit HTTP header.",
"description": "Allows this server to advertise its quota policies and the current\nservice limits, thereby allowing clients to avoid being throttled.",
"externalDocs": {
"url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/",
"description": "IETF Draft - RateLimit header fields for HTTP"
},
"example": "\"default\";q=100;w=10"
}
}
}
}
},
"security": [
{
"CatalystRBACSecurityScheme": []
}
],
"operationId": "postDocument"
}
}
},
"components": {
"schemas": {
"ChainRootGetResponse": {
"type": "object",
"description": "GET RBAC chain root response.",
"required": [
"chain_root"
],
"properties": {
"chain_root": {
"type": "string",
"title": "Cardano 256-bit Hash",
"description": "RBAC certificate chain root.",
"example": "0xff561c1ce6becf136a5d3063f50d78b8db50b8a1d4c03b18d41a8e98a6a18aed",
"maxLength": 66,
"minLength": 66,
"pattern": "^0x[0-9a-f]{64}$"
}
},
"example": {
"chain_root": "0xff561c1ce6becf136a5d3063f50d78b8db50b8a1d4c03b18d41a8e98a6a18aed"
}
},
"Cip36Details": {
"type": "object",
"description": "CIP36 Registration Data as found on-chain.",
"required": [
"slot_no"
],
"properties": {
"slot_no": {
"type": "integer",
"format": "u64",
"title": "Cardano Blockchain Slot Number",
"description": "Blocks Slot Number that the registration certificate is in.",
"example": 1234567,
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"stake_pub_key": {
"type": "string",
"format": "hex:ed25519-public-key",
"title": "Ed25519 Public Key",
"description": "Full Stake Address (not hashed, 32 byte ED25519 Public key).",
"example": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[A-Fa-f0-9]{64}"
},
"vote_pub_key": {
"type": "string",
"format": "hex:ed25519-public-key",
"title": "Ed25519 Public Key",
"description": "Voting Public Key (Ed25519 Public key).",
"example": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[A-Fa-f0-9]{64}"
},
"nonce": {
"type": "integer",
"format": "u64",
"title": "Nonce",
"description": "The current slot at the time a transaction was posted.\nUsed to ensure out of order inclusion on-chain can be detected.\n\n*Note: Because a Nonce should never be greater than the slot of the transaction it is found in, \nexcessively large nonces are capped to the transactions slot number.*",
"example": 1234567,
"maximum": 1.8446744073709552e19,
"minimum": 0.0
},
"txn": {
"type": "integer",
"format": "u16",
"title": "Transaction Index",
"description": "The Index of a transaction within a block.",
"example": 7,
"maximum": 65535.0,
"minimum": 0.0
},
"payment_address": {
"type": "string",
"format": "cardano:cip19-address",
"title": "Cardano Payment Address",
"description": "Cardano Cip-19 Formatted Shelley Payment Address.",
"externalDocs": {
"url": "https://cips.cardano.org/cip/CIP-19",
"description": "CIP-19 - Cardano Addresses"
},
"example": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"maxLength": 108,
"minLength": 58,
"pattern": "(addr|addr_test)1([a,c-h,j-n,p-z,0,2-9]{53}|[a,c-h,j-n,p-z,0,2-9]{98})"
},
"is_payable": {
"type": "boolean",
"title": "Payable indicator",
"description": "If the payment address is a script, then it can not be payed rewards.",
"default": true,
"example": true
},
"cip15": {
"type": "boolean",
"title": "CIP-15 Indicator",
"description": "If this field is set, then the registration was in CIP15 format.",
"default": false,
"example": false
},
"errors": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "If there are errors with this registration, they are listed here.\nThis field is *NEVER* returned for a valid registration.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
}
},
"example": {
"cip15": false,
"is_payable": true,
"nonce": 1234567,
"payment_address": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"slot_no": 1234567,
"stake_pub_key": "0xDEF855AE45F3BF9640A5298A38B97617DE75600F796F17579BFB815543624B24",
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
},
"Cip36RegistrationList": {
"type": "object",
"description": "List of CIP36 Registration Data as found on-chain.",
"required": [
"slot",
"voting_key",
"invalid"
],
"properties": {
"slot": {
"type": "integer",
"format": "u64",
"title": "Cardano Blockchain Slot Number",
"description": "The Slot the Registrations are valid up until.\n\nAny registrations that occurred after this Slot are not included in the list.\nErrors are reported only if they fall between the last valid registration and this\nslot number.\nEarlier errors are never reported.",
"example": 1234567,
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"voting_key": {
"type": "array",
"description": "List of registrations associated with the query.",
"items": {
"$ref": "#/components/schemas/Cip36RegistrationsForVotingPublicKey"
},
"example": [
{
"registrations": [
{
"cip15": false,
"is_payable": true,
"nonce": 1234567,
"payment_address": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"slot_no": 1234567,
"stake_pub_key": "0xDEF855AE45F3BF9640A5298A38B97617DE75600F796F17579BFB815543624B24",
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"maxItems": 100
},
"invalid": {
"type": "array",
"description": "List of latest invalid registrations that were found, for the requested filter.",
"items": {
"$ref": "#/components/schemas/Cip36Details"
},
"example": [
{
"cip15": false,
"is_payable": true,
"nonce": 1234567,
"payment_address": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"slot_no": 1234567,
"stake_pub_key": "0xDEF855AE45F3BF9640A5298A38B97617DE75600F796F17579BFB815543624B24",
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"maxItems": 100
},
"page": {
"title": "The Page of CIP-36 Registration List.",
"description": "Current Page",
"allOf": [
{
"$ref": "#/components/schemas/CurrentPage"
},
{
"title": "The Page of CIP-36 Registration List.",
"example": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
],
"example": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
},
"example": {
"invalid": [
{
"cip15": true,
"errors": "{\"context\":\"Cip36\",\"report\":[{\"kind\":{\"type\":\"Other\",\"description\":\"Error occurred\"},\"context\":\"Cip36 decoding error\"}]}",
"is_payable": false,
"nonce": 1234664,
"slot_no": 1234702,
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"page": {
"limit": 10,
"page": 5,
"remaining": 16384
},
"slot": 1235202,
"voting_key": [
{
"registrations": [
{
"cip15": false,
"is_payable": true,
"nonce": 1234567,
"payment_address": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"slot_no": 1234567,
"stake_pub_key": "0xDEF855AE45F3BF9640A5298A38B97617DE75600F796F17579BFB815543624B24",
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
]
}
},
"Cip36RegistrationUnprocessableContent": {
"type": "object",
"description": "Cip36 Registration Validation Error.",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "Error messages.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
}
},
"example": {
"error": "Cip36 Registration in request body"
}
},
"Cip36RegistrationsForVotingPublicKey": {
"type": "object",
"description": "List of CIP36 Registration Data for a Voting Key.",
"required": [
"vote_pub_key",
"registrations"
],
"properties": {
"vote_pub_key": {
"type": "string",
"format": "hex:ed25519-public-key",
"title": "Ed25519 Public Key",
"description": "Voting Public Key",
"example": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8",
"maxLength": 66,
"minLength": 66,
"pattern": "0x[A-Fa-f0-9]{64}"
},
"registrations": {
"type": "array",
"description": "List of Registrations associated with this Voting Key",
"items": {
"$ref": "#/components/schemas/Cip36Details"
},
"example": [
{
"cip15": false,
"is_payable": true,
"nonce": 1234567,
"payment_address": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"slot_no": 1234567,
"stake_pub_key": "0xDEF855AE45F3BF9640A5298A38B97617DE75600F796F17579BFB815543624B24",
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"maxItems": 100
}
},
"example": {
"registrations": [
{
"cip15": false,
"is_payable": true,
"nonce": 1234567,
"payment_address": "addr_test1qz2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgs68faae",
"slot_no": 1234567,
"stake_pub_key": "0xDEF855AE45F3BF9640A5298A38B97617DE75600F796F17579BFB815543624B24",
"txn": 7,
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
],
"vote_pub_key": "0x56CDD154355E078A0990F9E633F9553F7D43A68B2FF9BEF78B9F5C71C808A7C8"
}
},
"ConfigEnvironment": {
"type": "string",
"description": "Frontend config environment.",
"enum": [
"dev",
"qa",
"prod"
]
},
"ConfigUnprocessableContent": {
"type": "object",
"description": "Configuration Data Validation Error.",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "Error messages.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
},
"schema_validation_errors": {
"type": "array",
"description": "Optional schema validation errors.",
"default": [],
"items": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "This is an error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
},
"example": [
"An error has occurred, the details of the error are ..."
],
"maxItems": 10
}
},
"example": {
"error": "Invalid Data",
"schema_validation_errors": [
"An error has occurred, the details of the error are ..."
]
}
},
"ContentErrorDetail": {
"type": "object",
"description": "Individual details of a single error that was detected with the content of the\nrequest.",
"properties": {
"loc": {
"type": "array",
"description": "The location of the error",
"items": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "This is an error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
},
"nullable": true,
"example": [
"An error has occurred, the details of the error are ..."
],
"maxItems": 10
},
"msg": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "The error message.",
"nullable": true,
"example": "An error has occurred, the details of the error are ...",
"maxLength": 1000,
"minLength": 1,
"pattern": "^[0-9a-zA-Z].*$"
},
"type": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "The type of error",
"nullable": true,
"example": "An error has occurred, the details of the error are ...",
"maxLength": 1000,
"minLength": 1,
"pattern": "^[0-9a-zA-Z].*$"
}
},
"example": {
"loc": [
"body"
],
"msg": "Value is not a valid dict.",
"type": "type_error.dict"
}
},
"CurrentPage": {
"type": "object",
"description": "Current Page of data being returned.",
"required": [
"page",
"limit",
"remaining"
],
"properties": {
"page": {
"type": "integer",
"format": "u32",
"title": "Page",
"description": "The page number of the data.\nThe size of each page, and its offset within the complete data set is determined by the `limit` parameter.",
"default": 0,
"example": 5,
"maximum": 4294967295.0,
"minimum": 0.0
},
"limit": {
"type": "integer",
"format": "u32",
"title": "Limit",
"description": "The size `limit` of each `page` of results.\nDetermines the maximum amount of data that can be returned in a valid response.\n\nThis `limit` of records of data will always be returned unless there is less data to return \nthan allowed for by the `limit` and `page`.\n\n*Exceeding the `page`/`limit` of all available records will not return `404`, it will return an \nempty response.*",
"default": 100,
"example": 10,
"maximum": 100.0,
"minimum": 1.0
},
"remaining": {
"type": "integer",
"format": "u32",
"title": "Remaining",
"description": "The number of items remaining to be returned after this page.\nThis is the absolute number of items remaining, and not the number of Pages.",
"example": 16384,
"maximum": 4294967295.0,
"minimum": 0.0
}
},
"example": {
"limit": 10,
"page": 5,
"remaining": 16384
}
},
"DeepQueryInspectionFlag": {
"type": "string",
"description": "Enable or Disable Deep Database Query Inspection.",
"enum": [
"enabled",
"disabled"
]
},
"DocumentIndexList": {
"type": "object",
"description": "A single page of documents.\n\nThe page limit is defined by the number of document versions,\nnot the number of Document IDs.",
"required": [
"docs",
"page"
],
"properties": {
"docs": {
"type": "array",
"description": "List of documents that matched the filter.\n\nDocuments are listed in ascending order.",
"items": {
"title": "Individual Indexed Document",
"description": "An Individual Indexed Document and its Versions.\nDocument Versions are listed in Ascending order.",
"allOf": [
{
"$ref": "#/components/schemas/IndexedDocument"
},
{
"title": "Individual Indexed Document",
"description": "An Individual Indexed Document and its Versions.\nDocument Versions are listed in Ascending order.",
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
}
],
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
},
"example": [
{
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
],
"maxItems": 4294967295
},
"page": {
"title": "The Page of Document Index List.",
"description": "Current Page",
"allOf": [
{
"$ref": "#/components/schemas/CurrentPage"
},
{
"title": "The Page of Document Index List.",
"example": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
],
"example": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
},
"example": {
"docs": [
{
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
],
"page": {
"limit": 10,
"page": 5,
"remaining": 16384
}
}
},
"DocumentIndexQueryFilter": {
"type": "object",
"description": "Query Filter for the generation of a signed document index.\n\nThe Query works as a filter which acts like a sieve to filter out documents\nwhich do not strictly match the metadata or payload fields included in the query\nitself.",
"properties": {
"type": {
"type": "string",
"format": "uuid",
"title": "Signed Document Type",
"description": "## Signed Document Type.\n\nThe document type must match one of the\n[Registered Document Types](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/)\n\nUUIDv4 Formatted 128bit value.",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#type",
"description": "Specification"
},
"example": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"id": {
"title": "Document ID Selector",
"description": "## Document ID\n\nEither an absolute single Document ID or a range of\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedId"
},
{
"title": "Document ID Selector",
"description": "Either a absolute single Document ID or a range of Document IDs",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"ver": {
"title": "Document Version Selector",
"description": "## Document Version\n\nEither an absolute single Document Version or a range of\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedVer"
},
{
"title": "Document Version Selector",
"description": "Either a absolute single Document Version or a range of Document Versions",
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
],
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"ref": {
"title": "Document Reference",
"description": "## Document Reference\n\nA [reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another signed document. This fields can match any reference that matches the\ndefined [Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nThe kind of document that the reference refers to is defined by the\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/)",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"template": {
"title": "Document Reference",
"description": "## Document Template\n\nDocuments that are created based on a template include the\n[template reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#template-template-reference)\nto another signed document. This fields can match any template reference that\nmatches the defined [Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nThe kind of document that the reference refers to is defined by the\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/)\nhowever, it will always be a template type document that matches the document\nitself.",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"reply": {
"title": "Document Reference",
"description": "## Document Reply\n\nThis is a\n[reply reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#reply-reply-reference)\nwhich links one document to another, when acting as a reply to it.\nReplies typically reference the same kind of document.\nThis fields can match any reply reference that matches the defined\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nThe kind of document that the reference refers to is defined by the\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/).",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"brand": {
"title": "Document Reference",
"description": "## Brand\n\nThis is a\n[brand reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#brand_id)\nto a brand document which defines the brand the document falls under.\nThis fields can match any brand reference that matches the defined\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nWhether a Document Type has a brand reference is defined by its\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/).",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"campaign": {
"title": "Document Reference",
"description": "## Campaign\n\nThis is a\n[campaign reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#campaign_id)\nto a campaign document which defines the campaign the document falls under.\nThis fields can match any campaign reference that matches the defined\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nWhether a Document Type has a campaign reference is defined by its\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/).",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"category": {
"title": "Document Reference",
"description": "## Category\n\nThis is a\n[category reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#category_id)\nto a category document which defines the category the document falls under.\nThis fields can match any category reference that matches the defined\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id)\nand/or\n[Document Versions](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver)\n\nWhether a Document Type has a category reference is defined by its\n[Document Type](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/types/).",
"allOf": [
{
"$ref": "#/components/schemas/IdAndVerRef"
},
{
"title": "Document Reference",
"description": "A Signed Documents\n[Reference](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/meta/#ref-document-reference)\nto another Documents ID and/or Version.\n\n*Note: at least one of `id` or `ver` must be defined.*",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
},
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"ref": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"reply": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"template": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
},
"DocumentReference": {
"type": "object",
"description": "A Reference to another Signed Document",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "Document ID Reference",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"ver": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "Document Version",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"EqOrRangedId": {
"type": "object",
"description": "Either a Single Document ID, or a Range of Document IDs",
"oneOf": [
{
"title": "ID Equals",
"description": "A specific single\n[Document ID](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id).",
"allOf": [
{
"$ref": "#/components/schemas/IdEq"
},
{
"title": "ID Equals",
"description": "A specific single\n[Document ID](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id).",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
{
"title": "ID Range",
"description": "A range of\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id).",
"allOf": [
{
"$ref": "#/components/schemas/IdRange"
},
{
"title": "ID Range",
"description": "A range of\n[Document IDs](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id).",
"example": {
"max": "01944e87-e68c-7fff-bfff-ffffffffffff",
"min": "01944e87-e68c-7000-8000-000000000000"
}
}
],
"example": {
"max": "01944e87-e68c-7fff-bfff-ffffffffffff",
"min": "01944e87-e68c-7000-8000-000000000000"
}
}
]
},
"EqOrRangedVer": {
"type": "object",
"description": "Document or Range of Documents\n\nEither a Single Document Version, or a Range of Document Versions",
"oneOf": [
{
"title": "Version Equals",
"description": "A specific single\n[Document Version](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver).",
"allOf": [
{
"$ref": "#/components/schemas/VerEq"
},
{
"title": "Version Equals",
"description": "A specific single\n[Document Version](https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver).",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
{
"title": "Version Range",
"description": "A range of [Document Versions]().",
"allOf": [
{
"$ref": "#/components/schemas/VerRange"
},
{
"title": "Version Range",
"description": "A range of [Document Versions]().",
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
],
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
]
},
"Forbidden": {
"type": "object",
"description": "The client has not sent valid authentication credentials for the requested\nresource.",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"title": "Error Unique ID",
"description": "Unique ID of this Server Error so that it can be located easily for debugging.",
"example": "230aff4c-0677-4350-b325-9a393530c044"
},
"msg": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "Error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
},
"required": {
"type": "array",
"description": "List or Roles required to access the resource.",
"items": {
"type": "string",
"maxLength": 100,
"pattern": "^[0-9a-zA-Z].*$"
},
"example": [
"VOTER",
"PROPOSER"
],
"maxItems": 100
}
},
"example": {
"id": "0b02255b-c49a-423f-b98c-1b578f9431d3",
"msg": "Your request was not successful because your authentication credentials do not have the required roles for the requested resource.",
"required": [
"VOTER",
"PROPOSER"
]
}
},
"FrontendConfig": {
"type": "object",
"description": "Frontend JSON schema.",
"properties": {
"sentry": {
"title": "Configured sentry using in `FrontendConfig`.",
"description": "Sentry properties.",
"allOf": [
{
"$ref": "#/components/schemas/Sentry"
},
{
"title": "Configured sentry using in `FrontendConfig`.",
"example": {
"dsn": "https://example.com/",
"environment": "dev",
"release": "1.0.0"
}
}
],
"example": {
"dsn": "https://example.com/",
"environment": "dev",
"release": "1.0.0"
}
}
},
"example": {
"sentry": {
"dsn": "https://example.com/",
"environment": "dev",
"release": "1.0.0"
}
}
},
"FullStakeInfo": {
"type": "object",
"description": "Full user's cardano stake info.",
"required": [
"volatile",
"persistent"
],
"properties": {
"volatile": {
"title": "Volatile stake information.",
"description": "Volatile stake information.",
"allOf": [
{
"$ref": "#/components/schemas/StakeInfo"
},
{
"title": "Volatile stake information.",
"example": {
"ada_amount": 1234567,
"native_tokens": [],
"slot_number": 1234567
}
}
],
"example": {
"ada_amount": 1234567,
"native_tokens": [],
"slot_number": 1234567
}
},
"persistent": {
"title": "Persistent stake information.",
"description": "Persistent stake information.",
"allOf": [
{
"$ref": "#/components/schemas/StakeInfo"
},
{
"title": "Persistent stake information.",
"example": {
"ada_amount": 1234567,
"native_tokens": [],
"slot_number": 1234567
}
}
],
"example": {
"ada_amount": 1234567,
"native_tokens": [],
"slot_number": 1234567
}
}
},
"example": {
"persistent": {
"ada_amount": 1234567,
"native_tokens": [],
"slot_number": 1234567
},
"volatile": {
"ada_amount": 1234567,
"native_tokens": [],
"slot_number": 1234567
}
}
},
"IdAndVerRef": {
"type": "object",
"description": "Either a Single Document ID, or a Range of Document IDs",
"anyOf": [
{
"title": "Document ID Reference",
"description": "A Reference to the Document ID Only.\n\nThis will match any document that matches the defined Document ID only.\nThe Document Version is not considered, and will match any version.",
"allOf": [
{
"$ref": "#/components/schemas/IdRefOnly"
},
{
"title": "Document ID Reference",
"description": "A Reference to the Document ID Only.\n\nThis will match any document that matches the defined Document ID only.\nThe Document Version is not considered, and will match any version.",
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
}
],
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
},
{
"title": "Document Version Reference",
"description": "A Reference to the Document Version, and optionally also the Document ID.\n\nThis will match any document that matches the defined Document Version and if\nspecified the Document ID.\nIf the Document ID is not specified, then all documents that match the version will be\nreturned in the index.",
"allOf": [
{
"$ref": "#/components/schemas/VerRefWithOptionalId"
},
{
"title": "Document Version Reference",
"description": "A Reference to the Document Version, and optionally also the Document ID.\n\nThis will match any document that matches the defined Document Version and if\nspecified the Document ID.\nIf the Document ID is not specified, then all documents that match the version will be\nreturned in the index.",
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
],
"example": {
"ver": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
]
},
"IdEq": {
"type": "object",
"description": "A single Document IDs.",
"required": [
"eq"
],
"properties": {
"eq": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "The exact Document ID to match against.",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"IdRange": {
"type": "object",
"description": "A range of Document IDs.",
"required": [
"min",
"max"
],
"properties": {
"min": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "Minimum Document ID to find (inclusive)",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"max": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "Maximum Document ID to find (inclusive)",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"max": "01944e87-e68c-7fff-bfff-ffffffffffff",
"min": "01944e87-e68c-7000-8000-000000000000"
}
},
"IdRefOnly": {
"type": "object",
"description": "A Reference to a Document ID/s and their version/s.",
"required": [
"id"
],
"properties": {
"id": {
"title": "Document ID Selector",
"description": "Document ID, or range of Document IDs",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedId"
},
{
"title": "Document ID Selector",
"description": "Either a absolute single Document ID or a range of Document IDs",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
},
"example": {
"id": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
},
"IndexedDocument": {
"type": "object",
"description": "List of Documents that matched the filter",
"required": [
"id",
"ver"
],
"properties": {
"id": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document ID",
"description": "Document ID that matches the filter",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#id",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"ver": {
"type": "array",
"description": "List of matching versions of the document.\n\nVersions are listed in ascending order.",
"items": {
"title": "Individual Document Version",
"description": "A Matching version of the document.\n\nMetadata fields which are not set in the document, are not included in the version\ninformation. used to filter documents based on those metadata fields.\nThis is equivalent to returning documents where those metadata fields either do not\nexist, or do exist, but have any value.",
"allOf": [
{
"$ref": "#/components/schemas/IndexedDocumentVersion"
},
{
"title": "Individual Document Version",
"description": "A Matching version of the document.\n\nMetadata fields which are not set in the document, are not included in the version\ninformation. used to filter documents based on those metadata fields.\nThis is equivalent to returning documents where those metadata fields either do not\nexist, or do exist, but have any value.",
"example": {
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"example": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
],
"maxItems": 100
}
},
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": [
{
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
]
}
},
"IndexedDocumentVersion": {
"type": "object",
"description": "List of Documents that matched the filter",
"required": [
"ver",
"type"
],
"properties": {
"ver": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "Document Version that matches the filter",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"type": {
"type": "string",
"format": "uuid",
"title": "Signed Document Type",
"description": "Document Type that matches the filter",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#type",
"description": "Specification"
},
"example": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"ref": {
"title": "Document Reference for filtered Documents.",
"description": "Document Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"title": "Document Reference for filtered Documents.",
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"reply": {
"title": "Document Reference for filtered Documents.",
"description": "Document Reply Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"title": "Document Reference for filtered Documents.",
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"template": {
"title": "Document Reference for filtered Documents.",
"description": "Document Template Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"title": "Document Reference for filtered Documents.",
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"brand": {
"title": "Document Reference for filtered Documents.",
"description": "Document Brand Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"title": "Document Reference for filtered Documents.",
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"campaign": {
"title": "Document Reference for filtered Documents.",
"description": "Document Campaign Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"title": "Document Reference for filtered Documents.",
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"category": {
"title": "Document Reference for filtered Documents.",
"description": "Document Category Reference that matches the filter",
"allOf": [
{
"$ref": "#/components/schemas/DocumentReference"
},
{
"title": "Document Reference for filtered Documents.",
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
},
"example": {
"ref": {
"id": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
},
"type": "7808d2ba-d511-40af-84e8-c0d1625fdfdc",
"ver": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"InternalServerError": {
"type": "object",
"description": "An internal server error occurred.\n\n*The contents of this response should be reported to the projects issue tracker.*",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"title": "Error Unique ID",
"description": "Unique ID of this Server Error so that it can be located easily for debugging.",
"example": "70689466-cdc7-4b4c-9d62-5a62f09a71f9"
},
"msg": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "Error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
},
"issue": {
"type": "string",
"format": "url",
"title": "URL String",
"description": "A URL to report an issue.",
"example": "https://example.com/"
}
},
"example": {
"id": "52f7bdf7-cebe-426d-9d28-0e4d4dc472b6",
"issue": "https://github.com/input-output-hk/catalyst-voices/issues/new?template=bug_report.yml&title=Internal+Server+Error+-+52f7bdf7-cebe-426d-9d28-0e4d4dc472b6",
"msg": "Internal Server Error. Please report the issue to the service owner."
}
},
"LogLevel": {
"type": "string",
"description": "Set of all log levels which can be selected.",
"enum": [
"debug",
"info",
"warn",
"error"
]
},
"Network": {
"type": "string",
"description": "Cardano network type.",
"enum": [
"mainnet",
"preprod",
"preview"
]
},
"PreconditionFailed": {
"type": "object",
"description": "The client has not sent valid data in its request, headers, parameters or body.",
"required": [
"detail"
],
"properties": {
"detail": {
"type": "array",
"description": "Details of each error in the content that was detected.\n\nNote: This may not be ALL errors in the content, as validation of content can stop\nat any point an error is detected.",
"items": {
"$ref": "#/components/schemas/ContentErrorDetail"
},
"example": [
{
"loc": [
"body"
],
"msg": "Value is not a valid dict.",
"type": "type_error.dict"
}
],
"maxItems": 1000,
"minItems": 1
}
},
"example": {
"detail": [
{
"loc": [
"body"
],
"msg": "Value is not a valid dict.",
"type": "type_error.dict"
}
]
}
},
"PutDocumentUnprocessableContent": {
"type": "object",
"description": "Put Document Validation Error.",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "Error messages.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
},
"report": {
"type": "object",
"description": "Error report JSON object.",
"example": {}
}
},
"example": {
"error": "Missing Document in request body",
"report": {}
}
},
"RbacRegistration": {
"type": "object",
"description": "GET RBAC registrations by chain root response list item.",
"required": [
"tx_hash"
],
"properties": {
"tx_hash": {
"type": "string",
"title": "Cardano 256-bit Hash",
"description": "Registration transaction hash.",
"example": "0xff561c1ce6becf136a5d3063f50d78b8db50b8a1d4c03b18d41a8e98a6a18aed",
"maxLength": 66,
"minLength": 66,
"pattern": "^0x[0-9a-f]{64}$"
}
},
"example": {
"tx_hash": "0xff561c1ce6becf136a5d3063f50d78b8db50b8a1d4c03b18d41a8e98a6a18aed"
}
},
"RbacRegistrationsResponse": {
"type": "object",
"description": "GET RBAC registrations by chain root response.",
"required": [
"registrations"
],
"properties": {
"registrations": {
"type": "array",
"description": "Registrations by RBAC chain root.",
"items": {
"$ref": "#/components/schemas/RbacRegistration"
},
"example": [
{
"tx_hash": "0xff561c1ce6becf136a5d3063f50d78b8db50b8a1d4c03b18d41a8e98a6a18aed"
}
],
"maxItems": 100000
}
},
"example": {
"registrations": [
{
"tx_hash": "0xff561c1ce6becf136a5d3063f50d78b8db50b8a1d4c03b18d41a8e98a6a18aed"
}
]
}
},
"RbacRole0ChainRootResponse": {
"type": "object",
"description": "GET RBAC chain root response.",
"required": [
"chain_root"
],
"properties": {
"chain_root": {
"type": "string",
"title": "Cardano 256-bit Hash",
"description": "RBAC certificate chain root.",
"example": "0xff561c1ce6becf136a5d3063f50d78b8db50b8a1d4c03b18d41a8e98a6a18aed",
"maxLength": 66,
"minLength": 66,
"pattern": "^0x[0-9a-f]{64}$"
}
},
"example": {
"chain_root": "0xff561c1ce6becf136a5d3063f50d78b8db50b8a1d4c03b18d41a8e98a6a18aed"
}
},
"Sentry": {
"type": "object",
"description": "Frontend configuration for Sentry.",
"required": [
"dsn"
],
"properties": {
"dsn": {
"type": "string",
"format": "url",
"title": "URL String",
"description": "The Data Source Name (DSN) for Sentry.",
"example": "https://example.com/"
},
"release": {
"type": "string",
"description": "A version of the code deployed to an environment.",
"example": "1.0.0",
"maxLength": 64,
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+([0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?$"
},
"environment": {
"title": "Configured sentry profile.",
"description": "The environment in which the application is running, e.g., 'dev', 'qa'.",
"allOf": [
{
"$ref": "#/components/schemas/ConfigEnvironment"
},
{
"title": "Configured sentry profile.",
"example": "dev"
}
],
"example": "dev"
}
},
"example": {
"dsn": "https://example.com/",
"environment": "dev",
"release": "1.0.0"
}
},
"ServiceUnavailable": {
"type": "object",
"description": "The service is not available, try again later.\n\n*This is returned when the service either has not started,\nor has become unavailable.*",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"title": "Error Unique ID",
"description": "Unique ID of this Server Error so that it can be located easily for debugging.",
"example": "37c45868-49fb-47d9-bdf4-7989ea8edcc9"
},
"msg": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "Error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
}
},
"example": {
"id": "94dff26d-75cd-44c5-a892-a3d83f891793",
"msg": "Service Unavailable. Indicates that the server is not ready to handle the request."
}
},
"StakeInfo": {
"type": "object",
"description": "User's cardano stake info.",
"required": [
"ada_amount",
"slot_number",
"native_tokens"
],
"properties": {
"ada_amount": {
"type": "integer",
"format": "u64",
"title": "Cardano Blockchain ADA coins value",
"description": "Total stake amount.",
"example": 1234567,
"maximum": 1.8446744073709552e19,
"minimum": 0.0
},
"slot_number": {
"type": "integer",
"format": "u64",
"title": "Cardano Blockchain Slot Number",
"description": "Block's slot number which contains the latest unspent UTXO.",
"example": 1234567,
"maximum": 9.223372036854776e18,
"minimum": 0.0
},
"native_tokens": {
"type": "array",
"description": "Native token infos.",
"items": {
"$ref": "#/components/schemas/StakedNativeTokenInfo"
},
"example": [
{
"amount": 1234567,
"asset_name": "My Cool\nAsset",
"policy_hash": "0x8eee77e5894c22268d5d12e6484ba713e7ddd595abba308d88d36943"
}
],
"maxItems": 1000
}
},
"example": {
"ada_amount": 1234567,
"native_tokens": [],
"slot_number": 1234567
}
},
"StakedNativeTokenInfo": {
"type": "object",
"description": "User's staked native token info.",
"required": [
"policy_hash",
"asset_name",
"amount"
],
"properties": {
"policy_hash": {
"type": "string",
"format": "hex:hash(28)",
"title": "28 Byte Hash",
"description": "Token policy hash.",
"example": "0x8eee77e5894c22268d5d12e6484ba713e7ddd595abba308d88d36943",
"maxLength": 58,
"minLength": 58,
"pattern": "0x[A-Fa-f0-9]{56}"
},
"asset_name": {
"type": "string",
"format": "cardano:asset_name",
"title": "Cardano Native Asset Name",
"description": "Token policies Asset Name.",
"example": "My Cool\nAsset",
"maxLength": 64,
"minLength": 0,
"pattern": "[\\S\\s]{0,64}"
},
"amount": {
"type": "integer",
"format": "i128",
"title": "Cardano native Asset Value",
"description": "Token Asset Value.",
"example": 1234567,
"maximum": 9.223372036854776e18,
"minimum": -9.223372036854776e18
}
},
"example": {
"amount": 1234567,
"asset_name": "My Cool\nAsset",
"policy_hash": "0x8eee77e5894c22268d5d12e6484ba713e7ddd595abba308d88d36943"
}
},
"TooManyRequests": {
"type": "object",
"description": "The client has sent too many requests in a given amount of time.",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"title": "Error Unique ID",
"description": "Unique ID of this Server Error so that it can be located easily for debugging.",
"example": "9acdb363-fb3f-4592-aa45-5d323571efbd"
},
"msg": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "Error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
}
},
"example": {
"id": "dc0b4ad1-4bef-4130-ba02-00243ce26a24",
"msg": "Too Many Requests. You have exceeded the rate limit for this endpoint."
}
},
"Unauthorized": {
"type": "object",
"description": "The client has not sent valid authentication credentials for the requested\nresource.",
"required": [
"id",
"msg"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"title": "Error Unique ID",
"description": "Unique ID of this Server Error so that it can be located easily for debugging.",
"example": "223e0a83-52f2-4bed-ace0-1b16b3f11422"
},
"msg": {
"type": "string",
"format": "error",
"title": "Error Message",
"description": "Error message.",
"example": "An error has occurred, the details of the error are ...",
"maxLength": 256,
"minLength": 1,
"pattern": "^(.){1,256}$"
}
},
"example": {
"id": "ce216b4e-9512-46a1-b559-524b08607c50",
"msg": "Your request was not successful because it lacks valid authentication credentials for the requested resource."
}
},
"VerEq": {
"type": "object",
"description": "A single Document IDs.",
"required": [
"eq"
],
"properties": {
"eq": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "The exact Document ID to match against.",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"VerRange": {
"type": "object",
"description": "Version Range\n\nA Range of document versions from minimum to maximum inclusive.",
"required": [
"min",
"max"
],
"properties": {
"min": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "Minimum Document Version to find (inclusive)",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
},
"max": {
"type": "string",
"format": "uuidv7",
"title": "Signed Document Version",
"description": "Maximum Document Version to find (inclusive)",
"externalDocs": {
"url": "https://input-output-hk.github.io/catalyst-libs/architecture/08_concepts/signed_doc/spec/#ver",
"description": "Specification"
},
"example": "01944e87-e68c-7f22-9df1-816863cfa5ff",
"maxLength": 36,
"minLength": 36,
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA0F]{3}-[0-9a-fA-F]{12}$"
}
},
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
},
"VerRefWithOptionalId": {
"type": "object",
"description": "A Reference to a Document ID/s and their version/s.",
"required": [
"ver"
],
"properties": {
"id": {
"title": "Document ID Selector",
"description": "Document ID, or range of Document IDs",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedId"
},
{
"title": "Document ID Selector",
"description": "Either a absolute single Document ID or a range of Document IDs",
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
}
],
"example": {
"eq": "01944e87-e68c-7f22-9df1-816863cfa5ff"
}
},
"ver": {
"title": "Document Version Selector",
"description": "Document Version, or Range of Document Versions",
"allOf": [
{
"$ref": "#/components/schemas/EqOrRangedVer"
},
{
"title": "Document Version Selector",
"description": "Either a absolute single Document Version or a range of Document Versions",
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
],
"example": {
"max": "01944e87-e68c-7f22-9df1-000000000000",
"min": "01944e87-e68c-7f22-9df1-ffffffffffff"
}
}
}
}
},
"securitySchemes": {
"CatalystRBACSecurityScheme": {
"type": "http",
"description": "Catalyst RBAC Access Token",
"scheme": "bearer",
"bearerFormat": "catalyst-rbac-token"
},
"NoAuthorization": {
"type": "http",
"description": "Endpoint can be used without any authorization.",
"scheme": "none"
}
}
}
}