{ "openapi": "3.2.0", "info": { "title": "API Challenges Simple Todo List", "description": "A Simple todo list", "version": "1.0.0" }, "servers": [ { "url": "https://apichallenges.com", "description": "cloud hosted version" }, { "url": "http://localhost:4567", "description": "local execution" } ], "paths": { "/api/todos": { "get": { "summary": "return all the instances of todo", "description": "return all the instances of todo", "parameters": [ { "name": "_sortBy", "in": "query", "description": "Sort collection results by a field. Use +field or field for ascending order, and -field for descending order. Multiple fields can be combined with commas, e.g. +field,-other.", "required": false, "schema": { "type": "string" }, "example": "+id" }, { "name": "_limit", "in": "query", "description": "Limit collection results. Defaults to 10 and is capped at 20.", "required": false, "schema": { "type": "integer", "format": "int32", "maximum": 20, "minimum": 0 }, "example": 10 }, { "name": "_offset", "in": "query", "description": "Zero-based number of collection results to skip.", "required": false, "schema": { "type": "integer", "format": "int32", "minimum": 0 }, "example": 0 }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "All the todos", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todos" } }, "application/xml": { "schema": { "type": "array", "description": "todos", "items": { "type": "object", "description": "todo", "properties": { "id": { "type": "integer", "format": "int32", "description": "Field is an ID and should not be amended or set.", "example": 36 }, "title": { "type": "string", "description": "The title of the TODO Item. Value is mandatory. Value can not be empty. Maximum length allowed is 50.", "example": "A title" }, "doneStatus": { "type": "boolean", "description": "Status to track the todo completion. Value must be a Boolean (true, false) value.", "example": false }, "description": { "type": "string", "description": "Longer description of the todo. Maximum length allowed is 200.", "example": "my description" } }, "required": [ "description", "doneStatus", "id", "title" ], "title": "todo", "xml": { "name": "todo", "wrapped": true } }, "title": "todos", "xml": { "name": "todos", "wrapped": true } } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "type": "array", "description": "todos", "items": { "type": "object", "description": "todo", "properties": { "id": { "type": "integer", "format": "int32", "description": "Field is an ID and should not be amended or set.", "example": 36 }, "title": { "type": "string", "description": "The title of the TODO Item. Value is mandatory. Value can not be empty. Maximum length allowed is 50.", "example": "A title" }, "doneStatus": { "type": "boolean", "description": "Status to track the todo completion. Value must be a Boolean (true, false) value.", "example": false }, "description": { "type": "string", "description": "Longer description of the todo. Maximum length allowed is 200.", "example": "my description" } }, "required": [ "description", "doneStatus", "id", "title" ], "title": "todo", "xml": { "name": "todo", "wrapped": true } }, "title": "todos", "xml": { "name": "todos", "wrapped": true } } } } } } }, "put": { "summary": "method not allowed", "description": "method not allowed", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } }, "required": true }, "responses": { "400": { "description": "Error processing request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "201": { "description": "OK, Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "415": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "422": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "409": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "401": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } }, "security": [ { "challengerSession": [] } ] }, "post": { "summary": "we should be able to create todo without a ID using the field values in the body of the message. A maximum of 20 todos is allowed.", "description": "we should be able to create todo without a ID using the field values in the body of the message. A maximum of 20 todos is allowed.", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/create_todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/create_todo" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/create_todo" } } }, "required": true }, "responses": { "201": { "description": "Created a todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } } }, "400": { "description": "Error when creating a todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "422": { "description": "Validation error when creating a todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "409": { "description": "Conflict when creating a todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "415": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "401": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } }, "security": [ { "challengerSession": [] } ] }, "options": { "summary": "show all Options for endpoint of /api/todos", "description": "show all Options for endpoint of /api/todos", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "the endpoint verb options" } } }, "head": { "summary": "headers for all the instances of todo", "description": "headers for all the instances of todo", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK" } } }, "query": { "summary": "query all the instances of todo using application/x-www-form-urlencoded, application/jsonpath, application/vnd.thingifier.query+json query content", "description": "query all the instances of todo using application/x-www-form-urlencoded, application/jsonpath, application/vnd.thingifier.query+json query content", "parameters": [ { "name": "_sortBy", "in": "query", "description": "Sort collection results by a field. Use +field or field for ascending order, and -field for descending order. Multiple fields can be combined with commas, e.g. +field,-other.", "required": false, "schema": { "type": "string" }, "example": "+id" }, { "name": "_limit", "in": "query", "description": "Limit collection results. Defaults to 10 and is capped at 20.", "required": false, "schema": { "type": "integer", "format": "int32", "maximum": 20, "minimum": 0 }, "example": 10 }, { "name": "_offset", "in": "query", "description": "Zero-based number of collection results to skip.", "required": false, "schema": { "type": "integer", "format": "int32", "minimum": 0 }, "example": 0 }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "All the matching todos", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todos" } }, "application/xml": { "schema": { "type": "array", "description": "todos", "items": { "type": "object", "description": "todo", "properties": { "id": { "type": "integer", "format": "int32", "description": "Field is an ID and should not be amended or set.", "example": 11 }, "title": { "type": "string", "description": "The title of the TODO Item. Value is mandatory. Value can not be empty. Maximum length allowed is 50.", "example": "A title" }, "doneStatus": { "type": "boolean", "description": "Status to track the todo completion. Value must be a Boolean (true, false) value.", "example": false }, "description": { "type": "string", "description": "Longer description of the todo. Maximum length allowed is 200.", "example": "my description" } }, "required": [ "description", "doneStatus", "id", "title" ], "title": "todo", "xml": { "name": "todo", "wrapped": true } }, "title": "todos", "xml": { "name": "todos", "wrapped": true } } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "type": "array", "description": "todos", "items": { "type": "object", "description": "todo", "properties": { "id": { "type": "integer", "format": "int32", "description": "Field is an ID and should not be amended or set.", "example": 11 }, "title": { "type": "string", "description": "The title of the TODO Item. Value is mandatory. Value can not be empty. Maximum length allowed is 50.", "example": "A title" }, "doneStatus": { "type": "boolean", "description": "Status to track the todo completion. Value must be a Boolean (true, false) value.", "example": false }, "description": { "type": "string", "description": "Longer description of the todo. Maximum length allowed is 200.", "example": "my description" } }, "required": [ "description", "doneStatus", "id", "title" ], "title": "todo", "xml": { "name": "todo", "wrapped": true } }, "title": "todos", "xml": { "name": "todos", "wrapped": true } } } } }, "400": { "description": "Error processing request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "413": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "415": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "422": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } }, "requestBody": { "required": false, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "application/jsonpath": { "schema": { "type": "string" } }, "application/vnd.thingifier.query+json": { "schema": { "type": "object", "properties": { "filter": { "type": "object" }, "sort": { "type": "array", "items": { "type": "object" } }, "limit": { "type": "integer", "minimum": 0 }, "offset": { "type": "integer", "minimum": 0 } } } } } } } }, "/api/todos/{id}": { "get": { "summary": "return a specific instances of todo using a id", "description": "return a specific instances of todo using a id", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" }, "example": 78 }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "A specific todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } } }, "404": { "description": "Could not find a specific todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } } }, "put": { "summary": "amend a specific instances of todo using a id with a body containing the fields to amend", "description": "amend a specific instances of todo using a id with a body containing the fields to amend", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" }, "example": 93 }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } }, "required": true }, "responses": { "400": { "description": "Error processing request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "201": { "description": "OK, Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "415": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "422": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "409": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "401": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } }, "security": [ { "challengerSession": [] } ] }, "post": { "summary": "amend a specific instances of todo using a id with a body containing the fields to amend", "description": "amend a specific instances of todo using a id with a body containing the fields to amend", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" }, "example": 64 }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } }, "required": true }, "responses": { "200": { "description": "Amended the specific todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } } }, "404": { "description": "Could not find a specific todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "422": { "description": "Validation error when amending a todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "409": { "description": "Conflict when amending a todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "400": { "description": "Error processing request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "415": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "401": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } }, "security": [ { "challengerSession": [] } ] }, "delete": { "summary": "delete a specific instances of todo using a id", "description": "delete a specific instances of todo using a id", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" }, "example": 10 }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "Deleted a specific todo" }, "404": { "description": "Could not find a specific todo", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "401": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } }, "security": [ { "challengerSession": [] } ] }, "options": { "summary": "show all Options for endpoint of /api/todos/:id", "description": "show all Options for endpoint of /api/todos/:id", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" }, "example": 5 }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "Accept-Patch": { "description": "application/json, application/merge-patch+json, application/json-patch+json", "schema": { "type": "string" } } } } } }, "head": { "summary": "headers for a specific instances of todo using a id", "description": "headers for a specific instances of todo using a id", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" }, "example": 2 }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Headers for a specific todo" }, "404": { "description": "Could not find a specific todo" } } }, "patch": { "summary": "patch a specific instance of todo with a body containing the patch details", "description": "patch a specific instance of todo with a body containing the patch details", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer", "format": "int32" }, "example": 80 }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/merge-patch+json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/json-patch+json": { "schema": { "$ref": "#/components/schemas/todo" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/todo" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/todo" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/todo" } } } }, "400": { "description": "Error processing request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "415": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "422": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "409": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "401": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } }, "security": [ { "challengerSession": [] } ] } }, "/api/secret/token": { "get": { "summary": "GET /api/secret/token with basic auth to get an X-AUTH-TOKEN header and token response body for access to /api/secret/note.", "description": "GET /api/secret/token with basic auth to get an X-AUTH-TOKEN header and token response body for access to /api/secret/note.", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "A specific secrettoken", "headers": { "X-AUTH-TOKEN": { "description": "Value from returned instance field token", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretTokenResponse" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/SecretTokenResponse" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/SecretTokenResponse" } } } }, "404": { "description": "Not Found", "headers": { "X-AUTH-TOKEN": { "description": "Value from returned instance field token", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "401": { "description": "Standard Status Code Meaning", "headers": { "X-AUTH-TOKEN": { "description": "Value from returned instance field token", "schema": { "type": "string" } } } } }, "security": [ { "secretTokenBasic": [] } ] }, "options": { "summary": "return supported verbs for fixed route /api/secret/token", "description": "return supported verbs for fixed route /api/secret/token", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "the fixed endpoint verb options" } } } }, "/api/secret/note": { "get": { "summary": "GET /api/secret/note with X-AUTH-TOKEN to return the secret note for the user.", "description": "GET /api/secret/note with X-AUTH-TOKEN to return the secret note for the user.", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "A specific secretnote", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretNoteResponse" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/SecretNoteResponse" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/SecretNoteResponse" } } } }, "404": { "description": "Not Found", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "401": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } }, "403": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } }, "406": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } } }, "security": [ { "secretNoteToken": [] }, { "secretNoteApiKey": [] } ] }, "post": { "summary": "POST /api/secret/note with X-AUTH-TOKEN, and a payload of `{'note':'contents of note'}` to amend the contents of the secret note.", "description": "POST /api/secret/note with X-AUTH-TOKEN, and a payload of `{'note':'contents of note'}` to amend the contents of the secret note.", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/create_SecretNoteResponse" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/create_SecretNoteResponse" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/create_SecretNoteResponse" } } }, "required": true }, "responses": { "200": { "description": "Updated the fixed secretnote", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecretNoteResponse" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/SecretNoteResponse" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/SecretNoteResponse" } } } }, "404": { "description": "Not Found", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "415": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "422": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "409": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "400": { "description": "Error processing request", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } }, "401": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } }, "403": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } }, "406": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } } }, "security": [ { "secretNoteToken": [] }, { "secretNoteApiKey": [] } ] }, "options": { "summary": "return supported verbs for fixed route /api/secret/note", "description": "return supported verbs for fixed route /api/secret/note", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "the fixed endpoint verb options" } } }, "head": { "summary": "map /api/secret/note to fixed secretnote instance note", "description": "map /api/secret/note to fixed secretnote instance note", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } }, "401": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } }, "403": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } }, "406": { "description": "Standard Status Code Meaning", "headers": { "WWW-Authenticate": { "description": "Bearer", "schema": { "type": "string" } } } } }, "security": [ { "secretNoteToken": [] }, { "secretNoteApiKey": [] } ] } }, "/api/challenger/{guid}": { "get": { "summary": "Get a challenger in Json format to allow continued tracking of challenges.", "description": "Get a challenger in Json format to allow continued tracking of challenges.", "parameters": [ { "name": "guid", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "112692a8-0ffc-41cc-9e8f-7bbf43daeda7" }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "xAuthToken": { "type": "string", "format": "uuid" }, "xChallenger": { "type": "string", "format": "uuid" }, "secretNote": { "type": "string" }, "challengeStatus": { "type": "object", "additionalProperties": { "type": "boolean" } } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ] } } } } } }, "put": { "summary": "Restore a saved challenger matching the supplied X-CHALLENGER guid to allow continued tracking of challenges.", "description": "Restore a saved challenger matching the supplied X-CHALLENGER guid to allow continued tracking of challenges.", "parameters": [ { "name": "guid", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "e6ed389e-3607-46b8-b67c-7f7eb3b56e2e" }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "xAuthToken": { "type": "string", "format": "uuid" }, "xChallenger": { "type": "string", "format": "uuid" }, "secretNote": { "type": "string" }, "challengeStatus": { "type": "object", "additionalProperties": { "type": "boolean" } } } } } } }, "201": { "description": "OK, Created" }, "400": { "description": "Error processing request", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ] } } } }, "409": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ] } } } } } } }, "/api/challenger": { "post": { "summary": "Create a challenger using the X-CHALLENGER guid header.", "description": "Create a challenger using the X-CHALLENGER guid header.", "responses": { "200": { "description": "OK" }, "201": { "description": "OK, Created" }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ] } } } } } } }, "/api/challenger/database/{guid}": { "get": { "summary": "Get the todo data for the supplied X-CHALLENGER guid to allow later restoration of the todos.", "description": "Get the todo data for the supplied X-CHALLENGER guid to allow later restoration of the todos.", "parameters": [ { "name": "guid", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "885b7f47-c3a3-4d34-9179-da998eaf70e9" }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "todos": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "title": { "type": "string" }, "doneStatus": { "type": "boolean" }, "description": { "type": "string" } } } } } } } } }, "400": { "description": "Error processing request", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ] } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ] } } } } } }, "put": { "summary": "Restore a saved set of todos for a challenger matching the supplied X-CHALLENGER guid.", "description": "Restore a saved set of todos for a challenger matching the supplied X-CHALLENGER guid.", "parameters": [ { "name": "guid", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "5b09c38a-5150-4417-9541-4e7676c45345" }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "OK, No Content" }, "400": { "description": "Error processing request", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ] } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ] } } } } } } }, "/api/challenges": { "get": { "summary": "Get list of challenges and their completion status", "description": "Get list of challenges and their completion status", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "challenges": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "name": { "type": "string" }, "description": { "type": "string" }, "status": { "type": "boolean" } } } } } } } } }, "431": { "description": "Standard Status Code Meaning", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } } }, "options": { "summary": "Options for list of challenges endpoint", "description": "Options for list of challenges endpoint", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK" } } }, "head": { "summary": "Headers for list of challenges endpoint", "description": "Headers for list of challenges endpoint", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/heartbeat": { "get": { "summary": "Is the server running? YES 204", "description": "Is the server running? YES 204", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "OK, No Content" } } }, "options": { "summary": "Options for heartbeat endpoint", "description": "Options for heartbeat endpoint", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "OK, No Content" } } }, "head": { "summary": "Headers for heartbeat endpoint", "description": "Headers for heartbeat endpoint", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "OK, No Content" } } } }, "/api/todos/export": { "get": { "summary": "Export todos using a format query parameter. Supported values are: json, xml, text-xml, csv, text, html, ndjson, jsonl, json-seq, tsv", "description": "Export todos using a format query parameter. Supported values are: json, xml, text-xml, csv, text, html, ndjson, jsonl, json-seq, tsv", "parameters": [ { "name": "format", "in": "query", "description": "Export format short name, e.g. csv, html, tsv, json, xml, text-xml, text, ndjson, jsonl, or json-seq", "required": false, "schema": { "type": "string" }, "example": "sunt in culpa qui oa" }, { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "Content-Disposition": { "description": "attachment; filename=\"todos.{extension}\"", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "todos": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "title": { "type": "string" }, "doneStatus": { "type": "boolean" }, "description": { "type": "string" } } } } } } }, "application/xml": { "schema": { "type": "string" } }, "text/xml": { "schema": { "type": "string" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } } } }, "400": { "description": "Error processing request", "headers": { "Content-Disposition": { "description": "attachment; filename=\"todos.{extension}\"", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ] } } } }, "431": { "description": "Standard Status Code Meaning", "headers": { "Content-Disposition": { "description": "attachment; filename=\"todos.{extension}\"", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } }, "text/csv": { "schema": { "type": "string" } }, "text/plain": { "schema": { "type": "string" } }, "text/html": { "schema": { "type": "string" } }, "application/x-ndjson": { "schema": { "type": "string" } }, "application/jsonl": { "schema": { "type": "string" } }, "application/json-seq": { "schema": { "type": "string" } }, "text/tab-separated-values": { "schema": { "type": "string" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ThingifierError" } } } } } }, "options": { "summary": "CORS preflight options for exporting todos", "description": "CORS preflight options for exporting todos", "parameters": [ { "name": "X-CHALLENGER", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "OK, No Content", "headers": { "Allow": { "description": "GET, OPTIONS", "schema": { "type": "string" } } } } } } } }, "components": { "schemas": { "secrettoken": { "type": "object", "description": "secrettoken", "properties": { "id": { "type": "string", "description": "Value is mandatory.", "example": "im ad minim veniam,a" }, "token": { "type": "string", "description": "Value is mandatory.", "example": "cepteur sint occaeca" } }, "title": "secrettoken", "xml": { "name": "secrettoken", "wrapped": true } }, "create_secrettoken": { "type": "object", "description": "secrettoken", "properties": { "id": { "type": "string", "description": "Value is mandatory.", "example": "dolor in reprehender" }, "token": { "type": "string", "description": "Value is mandatory.", "example": "re eu fugiat nulla p" } }, "title": "create secrettoken", "xml": { "name": "secrettoken", "wrapped": true } }, "secrettokens": { "type": "object", "description": "secrettokens", "properties": { "secrettokens": { "type": "array", "items": { "type": "object", "description": "secrettoken", "properties": { "id": { "type": "string", "description": "Value is mandatory.", "example": "o consequat. Duis au" }, "token": { "type": "string", "description": "Value is mandatory.", "example": "m dolore eu fugiat n" } }, "required": [ "id", "token" ], "title": "secrettoken", "xml": { "name": "secrettoken", "wrapped": true } } } }, "required": [ "secrettokens" ], "title": "secrettokens" }, "SecretTokenResponse": { "type": "object", "description": "secrettoken", "properties": { "token": { "type": "string", "description": "Value is mandatory.", "example": "orem ipsum dolor sit" } }, "title": "SecretTokenResponse", "xml": { "name": "secrettoken", "wrapped": true } }, "create_SecretTokenResponse": { "type": "object", "description": "secrettoken", "properties": { "token": { "type": "string", "description": "Value is mandatory.", "example": "ecat cupidatat non p" } }, "title": "create SecretTokenResponse", "xml": { "name": "secrettoken", "wrapped": true } }, "secretnote": { "type": "object", "description": "secretnote", "properties": { "id": { "type": "string", "description": "Value is mandatory.", "example": ". Excepteur sint occ" }, "note": { "type": "string", "description": "Value is mandatory. Maximum length allowed is 100.", "example": "officia deserunt mol" } }, "title": "secretnote", "xml": { "name": "secretnote", "wrapped": true } }, "create_secretnote": { "type": "object", "description": "secretnote", "properties": { "id": { "type": "string", "description": "Value is mandatory.", "example": "minim veniam, quis n" }, "note": { "type": "string", "description": "Value is mandatory. Maximum length allowed is 100.", "example": "lit esse cillum dolo" } }, "title": "create secretnote", "xml": { "name": "secretnote", "wrapped": true } }, "secretnotes": { "type": "object", "description": "secretnotes", "properties": { "secretnotes": { "type": "array", "items": { "type": "object", "description": "secretnote", "properties": { "id": { "type": "string", "description": "Value is mandatory.", "example": "qui officia deserunt" }, "note": { "type": "string", "description": "Value is mandatory. Maximum length allowed is 100.", "example": "in voluptate velitaa" } }, "required": [ "id", "note" ], "title": "secretnote", "xml": { "name": "secretnote", "wrapped": true } } } }, "required": [ "secretnotes" ], "title": "secretnotes" }, "SecretNoteResponse": { "type": "object", "description": "secretnote", "properties": { "note": { "type": "string", "description": "Value is mandatory. Maximum length allowed is 100.", "example": "in culpa qui officia" } }, "title": "SecretNoteResponse", "xml": { "name": "secretnote", "wrapped": true } }, "create_SecretNoteResponse": { "type": "object", "description": "secretnote", "properties": { "note": { "type": "string", "description": "Value is mandatory. Maximum length allowed is 100.", "example": "commodo consequat. D" } }, "title": "create SecretNoteResponse", "xml": { "name": "secretnote", "wrapped": true } }, "todo": { "type": "object", "description": "todo", "properties": { "id": { "type": "integer", "format": "int32", "description": "Field is an ID and should not be amended or set.", "example": 44 }, "title": { "type": "string", "description": "The title of the TODO Item. Value is mandatory. Value can not be empty. Maximum length allowed is 50.", "example": "A title" }, "doneStatus": { "type": "boolean", "description": "Status to track the todo completion. Value must be a Boolean (true, false) value.", "example": false }, "description": { "type": "string", "description": "Longer description of the todo. Maximum length allowed is 200.", "example": "my description" } }, "title": "todo", "xml": { "name": "todo", "wrapped": true } }, "create_todo": { "type": "object", "description": "todo", "properties": { "title": { "type": "string", "description": "The title of the TODO Item. Value is mandatory. Value can not be empty. Maximum length allowed is 50.", "example": "A title" }, "doneStatus": { "type": "boolean", "description": "Status to track the todo completion. Value must be a Boolean (true, false) value.", "example": false }, "description": { "type": "string", "description": "Longer description of the todo. Maximum length allowed is 200.", "example": "my description" } }, "title": "create todo", "xml": { "name": "todo", "wrapped": true } }, "todos": { "type": "object", "description": "todos", "properties": { "todos": { "type": "array", "items": { "type": "object", "description": "todo", "properties": { "id": { "type": "integer", "format": "int32", "description": "Field is an ID and should not be amended or set.", "example": 74 }, "title": { "type": "string", "description": "The title of the TODO Item. Value is mandatory. Value can not be empty. Maximum length allowed is 50.", "example": "A title" }, "doneStatus": { "type": "boolean", "description": "Status to track the todo completion. Value must be a Boolean (true, false) value.", "example": false }, "description": { "type": "string", "description": "Longer description of the todo. Maximum length allowed is 200.", "example": "my description" } }, "required": [ "description", "doneStatus", "id", "title" ], "title": "todo", "xml": { "name": "todo", "wrapped": true } } } }, "required": [ "todos" ], "title": "todos" }, "ThingifierError": { "type": "object", "description": "Standard Thingifier error response", "properties": { "errorMessages": { "type": "array", "items": { "type": "string" } } }, "required": [ "errorMessages" ], "title": "ThingifierError" } }, "securitySchemes": { "secretNoteToken": { "type": "http", "scheme": "bearer" }, "secretTokenBasic": { "type": "http", "scheme": "basic" }, "secretNoteApiKey": { "type": "apiKey", "name": "X-AUTH-TOKEN", "in": "header" }, "challengerSession": { "type": "apiKey", "name": "X-CHALLENGER", "in": "header" } } } }