{ "openapi": "3.1.1", "info": { "title": "Aniyori API", "description": "Canonical anime data. Errors use Problem Details. Public API foundation.", "version": "v1" }, "servers": [ { "url": "/" } ], "paths": { "/v1/search": { "get": { "tags": [ "Search" ], "summary": "Search canonical anime titles", "description": "Fulltext, prefix and typo-tolerant search across preferred and alternative titles. Filters: year, format, status. q is required (1–200 characters); limit 1–50, default 20. after is the previous page.nextCursor, bound to q, filters and limit. Relevance pagination is not a snapshot; concurrent index changes may reorder results. Only the first 1000 hits are accessible; refine filters when truncated=true. Facets contain up to 20 values per field. Search is eventually consistent. Returns 503 when search is disabled or unavailable, never a fabricated empty result. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include search.read.", "operationId": "SearchAnime", "parameters": [ { "name": "q", "in": "query", "description": "Title query, 1–200 characters. Supports prefix and typo tolerance.", "required": true, "schema": { "type": "string" }, "example": "frieren" }, { "name": "limit", "in": "query", "description": "1–50; default 20.", "schema": { "type": "string" } }, { "name": "after", "in": "query", "description": "Opaque page.nextCursor. Keep query, filters and limit unchanged.", "schema": { "type": "string" } }, { "name": "year", "in": "query", "description": "1900–2200", "schema": { "type": "string" } }, { "name": "format", "in": "query", "description": "tv, movie, ova, ona, special, music, unknown", "schema": { "type": "string" } }, { "name": "status", "in": "query", "description": "announced, airing, finished, unknown", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnimeSearchPage" }, "example": { "items": [ ], "page": { "nextCursor": null }, "found": 0, "truncated": false, "facets": [ ] } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Unauthorized", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Forbidden", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "search.read" ] } ] } }, "/v1": { "get": { "tags": [ "Aniyori" ], "summary": "Get API information", "description": "Public API version and relative Scalar reference URL. Does not contact metadata providers.", "operationId": "GetPlatformInfo", "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformInfo" } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } } } }, "/v1/anime": { "get": { "tags": [ "Catalog" ], "summary": "List canonical anime", "description": "Keyset pagination with id.asc (default), title.asc (case-sensitive C collation), updated.desc. Limit 1–100 (default 25). Filters: year, season, format, status, genre slug, studio slug; AND combination. Cursors are bound to filters/sort; concurrent edits can move items between pages. Unknown query parameters are rejected. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "ListAnime", "parameters": [ { "name": "limit", "in": "query", "description": "1–100; default 25", "schema": { "type": "string" } }, { "name": "year", "in": "query", "schema": { "type": "string" } }, { "name": "season", "in": "query", "schema": { "type": "string" } }, { "name": "format", "in": "query", "schema": { "type": "string" } }, { "name": "after", "in": "query", "description": "Opaque page.nextCursor; keep filters and sort unchanged.", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "description": "id.asc (default), title.asc (case-sensitive C collation), updated.desc. UUID ascending tie-breaker.", "schema": { "type": "string" } }, { "name": "status", "in": "query", "description": "announced, airing, finished, unknown", "schema": { "type": "string" } }, { "name": "genre", "in": "query", "description": "Canonical genre slug from /v1/genres. Combined with other filters using AND.", "schema": { "type": "string" } }, { "name": "studio", "in": "query", "description": "Canonical studio slug from /v1/studios. Combined with other filters using AND.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnimePage" }, "example": { "items": [ ], "page": { "nextCursor": null } } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/anime/{id}": { "get": { "tags": [ "Catalog" ], "summary": "Get a canonical anime", "description": "UUID Aniyori ID. Supports weak ETag / If-None-Match and Last-Modified. Public responses require revalidation. Includes optional rich metadata: plain-text localized synopsis, duration, source, age category, licensed image URLs, canonical genres and studios. No runtime image fetch. fields/include are not yet supported. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "GetAnime", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "If-None-Match", "in": "header", "description": "Previously returned ETag", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "ETag": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnimeDetail" } } } }, "304": { "description": "Not Modified", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Not Found", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/anime/{id}/relations": { "get": { "tags": [ "Catalog" ], "summary": "Get canonical anime relations", "description": "Returns up to 100 directed relations and indicates truncation. No graph expansion or external provider calls. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "GetAnimeRelations", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnimeRelations" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Not Found", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/external/{provider}/{externalId}": { "get": { "tags": [ "Catalog" ], "summary": "Resolve an external identifier to a canonical anime", "description": " Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "ResolveExternalAnime", "parameters": [ { "name": "provider", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "externalId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalResolution" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Not Found", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/seasons/current": { "get": { "tags": [ "Catalog" ], "summary": "Get anime in the current UTC calendar quarter", "description": "Supports limit, after and format. Winter Jan–Mar; spring Apr–Jun; summer Jul–Sep; fall Oct–Dec. A prior-season cursor becomes invalid after a quarter boundary. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "GetCurrentSeason", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "string" } }, { "name": "after", "in": "query", "schema": { "type": "string" } }, { "name": "format", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnimePage" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/genres": { "get": { "tags": [ "Catalog taxonomy" ], "summary": "List canonical genres", "description": "Canonical UUIDs/slugs. limit 1–100 (default 25), after cursor, id.asc ordering. Anonymous reads or anime.read credentials; no provider calls. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "ListGenres", "parameters": [ { "name": "limit", "in": "query", "description": "1–100; default 25", "schema": { "type": "string" } }, { "name": "after", "in": "query", "description": "Opaque page.nextCursor; bound to this resource", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenrePage" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/studios": { "get": { "tags": [ "Catalog taxonomy" ], "summary": "List canonical studios", "description": "Canonical UUIDs/slugs. limit 1–100 (default 25), after cursor, id.asc ordering. Anonymous reads or anime.read credentials; no provider calls. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "ListStudios", "parameters": [ { "name": "limit", "in": "query", "description": "1–100; default 25", "schema": { "type": "string" } }, { "name": "after", "in": "query", "description": "Opaque page.nextCursor; bound to this resource", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StudioPage" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/genres/{id}": { "get": { "tags": [ "Catalog taxonomy" ], "summary": "Get a canonical genre", "description": "Canonical UUID; read permission is anime.read when using credentials. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "GetGenre", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaxonomyResource" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Not Found", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/studios/{id}": { "get": { "tags": [ "Catalog taxonomy" ], "summary": "Get a canonical studio", "description": "Canonical UUID; read permission is anime.read when using credentials. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "GetStudio", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaxonomyResource" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Not Found", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/episodes/releases": { "get": { "tags": [ "Releases and schedules" ], "summary": "Get confirmed episode releases", "description": "Source-confirmed releases only; latest first, UUID tie-breaker. Default last seven UTC dates plus today, capped at the first page's as-of time. from/to ISO 8601 offsets, to exclusive; maximum 31 days. limit 1–100, after, animeId and format. Does not infer release from a scheduled timestamp. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "ListEpisodeReleases", "parameters": [ { "name": "limit", "in": "query", "description": "1–100; default 25", "schema": { "type": "string" } }, { "name": "after", "in": "query", "description": "Opaque page.nextCursor; bound to timeline and filters; default window is preserved", "schema": { "type": "string" } }, { "name": "from", "in": "query", "description": "Inclusive. Supply with to; premieres use yyyy-MM-dd, episodes use ISO 8601 with offset", "schema": { "type": "string" } }, { "name": "to", "in": "query", "description": "Exclusive. Supply with from; maximum window 31 days", "schema": { "type": "string" } }, { "name": "format", "in": "query", "description": "Canonical anime format", "schema": { "type": "string" } }, { "name": "animeId", "in": "query", "description": "Canonical anime UUID", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EpisodePage" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/schedules": { "get": { "tags": [ "Releases and schedules" ], "summary": "Get planned episode releases", "description": "Scheduled/delayed episodes with known scheduledAt, earliest first. Default next seven days. Optional status=scheduled or delayed; defaults to both. from/to ISO timestamps with offsets, to exclusive, maximum 31 days; limit, after, animeId, format. Scheduled time is source data and may change; not a confirmation of broadcast or streaming availability. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "ListEpisodeSchedule", "parameters": [ { "name": "limit", "in": "query", "description": "1–100; default 25", "schema": { "type": "string" } }, { "name": "after", "in": "query", "description": "Opaque page.nextCursor; bound to timeline and filters; default window is preserved", "schema": { "type": "string" } }, { "name": "from", "in": "query", "description": "Inclusive. Supply with to; premieres use yyyy-MM-dd, episodes use ISO 8601 with offset", "schema": { "type": "string" } }, { "name": "to", "in": "query", "description": "Exclusive. Supply with from; maximum window 31 days", "schema": { "type": "string" } }, { "name": "format", "in": "query", "description": "Canonical anime format", "schema": { "type": "string" } }, { "name": "status", "in": "query", "description": "scheduled, delayed; omitted includes both", "schema": { "type": "string" } }, { "name": "animeId", "in": "query", "description": "Canonical anime UUID", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EpisodePage" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/anime/premieres": { "get": { "tags": [ "Releases and schedules" ], "summary": "Get anime premiering in a calendar window", "description": "Known catalog startDate; latest date first, UUID tie-breaker. Default last seven UTC dates plus today. from/to yyyy-MM-dd, to exclusive, maximum 31 days. limit, after, format and optional catalog status. Calendar dates do not imply an exact broadcast time or confirmed premiere; use status=airing to narrow the catalog state. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "ListAnimePremieres", "parameters": [ { "name": "limit", "in": "query", "description": "1–100; default 25", "schema": { "type": "string" } }, { "name": "after", "in": "query", "description": "Opaque page.nextCursor; bound to timeline and filters; default window is preserved", "schema": { "type": "string" } }, { "name": "from", "in": "query", "description": "Inclusive. Supply with to; premieres use yyyy-MM-dd, episodes use ISO 8601 with offset", "schema": { "type": "string" } }, { "name": "to", "in": "query", "description": "Exclusive. Supply with from; maximum window 31 days", "schema": { "type": "string" } }, { "name": "format", "in": "query", "description": "Canonical anime format", "schema": { "type": "string" } }, { "name": "status", "in": "query", "description": "announced, airing, finished, unknown", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PremierePage" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/anime/{id}/episodes": { "get": { "tags": [ "Releases and schedules" ], "summary": "Get a canonical anime's episodes", "description": "Imported numbered episodes only, number ascending. No placeholders inferred from total episode count. limit 1–100 (default 25), after; unknown anime returns 404, known anime with no imported episodes returns an empty list. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "ListAnimeEpisodes", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "1–100; default 25", "schema": { "type": "string" } }, { "name": "after", "in": "query", "description": "Opaque page.nextCursor; bound to timeline and filters; default window is preserved", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EpisodePage" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Not Found", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/episodes/{id}": { "get": { "tags": [ "Releases and schedules" ], "summary": "Get a canonical episode", "description": "Canonical UUIDv7 ID; independent scheduled and confirmed release timestamps; UTC ISO 8601. No runtime source calls. Anonymous access is allowed with a lower quota. Supplied credentials must be valid and include anime.read.", "operationId": "GetEpisode", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EpisodeResource" } } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Not Found", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Service Unavailable", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { }, { "apiKey": [ ] }, { "aniyori": [ "anime.read" ] } ] } }, "/v1/me": { "get": { "tags": [ "Me" ], "summary": "GetCurrentUser", "description": "Required scope: profile.read", "operationId": "GetCurrentUser", "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "ETag": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeProfile" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "profile.read" ] } ] }, "patch": { "tags": [ "Me" ], "summary": "UpdateCurrentUser", "description": "Required scope: profile.write. If-Match revision required. Explicit fields only.", "operationId": "UpdateCurrentUser", "parameters": [ { "name": "If-Match", "in": "header", "description": "Strong revision ETag from GET, e.g. \"1\"", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "displayName": { "type": "string" }, "bio": { "type": [ "null", "string" ] }, "preferredLanguage": { "type": "string" }, "preferredRegion": { "type": "string" } }, "additionalProperties": false }, "example": { "displayName": "Developer" } } }, "required": true }, "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeProfile" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "profile.write" ] } ] } }, "/v1/me/library": { "get": { "tags": [ "Library" ], "summary": "ListUserLibrary", "description": "Required scope: library.read. Private keyset pagination, status, sort, cursor, limit.", "operationId": "ListUserLibrary", "parameters": [ { "name": "status", "in": "query", "description": "watching, completed, planned, on_hold, dropped", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "description": "updated.desc (default), title.asc, score.desc, started.desc", "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "description": "Opaque nextCursor from the previous response", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "1–100; default 24", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LibraryPage" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "library.read" ] } ] } }, "/v1/me/library/{animeId}": { "get": { "tags": [ "Library" ], "summary": "GetUserLibraryEntry", "description": "Required scope: library.read", "operationId": "GetUserLibraryEntry", "parameters": [ { "name": "animeId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "ETag": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LibraryItem" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "library.read" ] } ] }, "put": { "tags": [ "Library" ], "summary": "PutUserLibraryEntry", "description": "Required scope: library.write; rating changes additionally require ratings.write. If-Match required to change an existing entry; If-None-Match: * creates only. Identical PUT is a no-op.", "operationId": "PutUserLibraryEntry", "parameters": [ { "name": "animeId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "If-None-Match", "in": "header", "description": "Use * to create only if absent", "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "description": "Strong revision ETag from GET, e.g. \"1\"", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "episodesWatched": { "type": "integer", "format": "int32" }, "score": { "type": [ "null", "integer" ], "format": "int32" } }, "additionalProperties": false }, "example": { "status": "watching" } } }, "required": true }, "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LibraryItem" } } } }, "201": { "description": "Created", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LibraryItem" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "library.write" ] } ] }, "patch": { "tags": [ "Library" ], "summary": "UpdateUserLibraryEntry", "description": "Required scope: library.write; rating changes additionally require ratings.write. Requires If-Match revision.", "operationId": "UpdateUserLibraryEntry", "parameters": [ { "name": "animeId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "If-Match", "in": "header", "description": "Strong revision ETag from GET, e.g. \"1\"", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "episodesWatched": { "type": "integer", "format": "int32" }, "score": { "type": [ "null", "integer" ], "format": "int32" } }, "additionalProperties": false }, "example": { "episodesWatched": 1 } } }, "required": true }, "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LibraryItem" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "library.write" ] } ] }, "delete": { "tags": [ "Library" ], "summary": "DeleteUserLibraryEntry", "description": "Required scope: library.write. Requires If-Match revision.", "operationId": "DeleteUserLibraryEntry", "parameters": [ { "name": "animeId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "If-Match", "in": "header", "description": "Strong revision ETag from GET, e.g. \"1\"", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "No Content", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "library.write" ] } ] } }, "/v1/developer/applications": { "get": { "tags": [ "Developer applications" ], "summary": "List your applications", "description": "Up to 50 applications per owner. Owner comes from the human OAuth principal; API keys cannot manage applications.", "operationId": "ListDeveloperApplications", "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperApps" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.read" ] } ] }, "post": { "tags": [ "Developer applications" ], "summary": "Create an application", "description": "Immutable environment: development or production. Slug is unique per owner. UUIDv7 id is also the stable publicId.", "operationId": "CreateDeveloperApplication", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateApplicationInput" }, "example": { "name": "My integration", "slug": "my-integration", "description": null, "environment": "development" } } }, "required": true }, "responses": { "201": { "description": "Created", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperApp" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.write" ] } ] } }, "/v1/developer/applications/{applicationId}": { "get": { "tags": [ "Developer applications" ], "summary": "Read your application", "description": "Returns 404 for another owner's resource.", "operationId": "GetDeveloperApplication", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "ETag": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperApp" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.read" ] } ] }, "patch": { "tags": [ "Developer applications" ], "summary": "Update application name and description", "description": "Requires If-Match containing the revision ETag. Environment, owner and slug are immutable.", "operationId": "UpdateDeveloperApplication", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "If-Match", "in": "header", "description": "Strong revision ETag from GET, e.g. \"1\"", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateApplicationInput" }, "example": { "name": "My integration", "description": "A server-side anime bot" } } }, "required": true }, "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperApp" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.write" ] } ] }, "delete": { "tags": [ "Developer applications" ], "summary": "Disable an application and all its credentials", "description": "Idempotent soft deletion. Cannot be re-enabled by this API. Metadata remains available for audit.", "operationId": "DisableDeveloperApplication", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "No Content", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.write" ] } ] } }, "/v1/developer/applications/{applicationId}/keys": { "get": { "tags": [ "Developer applications" ], "summary": "List credential metadata", "description": "Up to 100 credentials per application, including revoked credentials. Never returns key material or hashes.", "operationId": "ListDeveloperApiKeys", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiKeys" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.read" ] } ] }, "post": { "tags": [ "Developer applications" ], "summary": "Create an API key; secret returned once", "description": "Allowed scope: anime.read. Empty scopes creates a credential without catalog permission. Store the returned secret immediately. Never retry a timed-out creation automatically.", "operationId": "CreateDeveloperApiKey", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateApiKeyInput" }, "example": { "name": "Bot server", "scopes": [ "anime.read" ], "expiresAt": null } } }, "required": true }, "responses": { "201": { "description": "Created", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatedApiKey" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.write" ] } ] } }, "/v1/developer/applications/{applicationId}/keys/{keyId}": { "patch": { "tags": [ "Developer applications" ], "summary": "Rename an API key", "description": "Only the credential name can change; scope and environment are immutable. Create a replacement to rotate.", "operationId": "RenameDeveloperApiKey", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "keyId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RenameApiKeyInput" }, "example": { "name": "Replacement server" } } }, "required": true }, "responses": { "204": { "description": "No Content", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.write" ] } ] }, "delete": { "tags": [ "Developer applications" ], "summary": "Revoke an API key immediately", "description": "Idempotent. Future requests are rejected; requests already in flight may complete.", "operationId": "RevokeDeveloperApiKey", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "keyId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "No Content", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.write" ] } ] } }, "/v1/developer/applications/{applicationId}/requests": { "get": { "tags": [ "Developer applications" ], "summary": "Read recent application request metadata", "description": "Eventually consistent best-effort telemetry, retained 31 days. No payloads, query strings or authorization headers. Cursor is the opaque page.nextCursor value; limit 1–100, default 25.", "operationId": "ListDeveloperRequests", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestLogs" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.read" ] } ] } }, "/v1/developer/applications/{applicationId}/usage": { "get": { "tags": [ "Developer applications" ], "summary": "Read application usage", "description": "UTC day/month, eventual best-effort counts, not billing records. Telemetry outages may undercount.", "operationId": "GetDeveloperUsage", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApplicationUsage" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "developers.read" ] } ] } }, "/v1/developer/applications/{applicationId}/webhooks": { "get": { "tags": [ "Webhooks" ], "summary": "List owned application webhook metadata", "description": "Up to 100 subscriptions including disabled/deleted metadata. Never returns secrets. Human webhooks.read scope required.", "operationId": "ListWebhookSubscriptions", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookSubscriptions" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "webhooks.read" ] } ] }, "post": { "tags": [ "Webhooks" ], "summary": "Subscribe to future published anime changes; secret shown once", "description": "Public HTTPS DNS destination on port 443; no query/credentials/fragment. Events anime.created/anime.updated. Starts after current committed publication sequence, without historical replay. Max 20 non-deleted and 100 lifetime subscriptions per application. A timed-out creation must not be retried automatically.", "operationId": "CreateWebhookSubscription", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWebhookInput" } } }, "required": true }, "responses": { "201": { "description": "Created", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookSecretResult" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "webhooks.write" ] } ] } }, "/v1/developer/applications/{applicationId}/webhooks/{subscriptionId}": { "get": { "tags": [ "Webhooks" ], "summary": "Read webhook metadata and revision ETag", "description": "404 for another application's subscription or another owner's application.", "operationId": "GetWebhookSubscription", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "ETag": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookSubscriptionResource" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "webhooks.read" ] } ] }, "patch": { "tags": [ "Webhooks" ], "summary": "Rename, select events or enable/disable a webhook", "description": "If-Match required. URL immutable; create a new subscription to change destination. Disabling cancels pending work; requests already claimed may complete. Re-enabling starts after current publications and does not backfill the disabled period.", "operationId": "UpdateWebhookSubscription", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWebhookInput" } } }, "required": true }, "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookSubscriptionResource" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "webhooks.write" ] } ] }, "delete": { "tags": [ "Webhooks" ], "summary": "Soft delete a subscription", "description": "If-Match required unless already deleted. Cancels pending work and preserves delivery audit metadata. Cannot re-enable a deleted subscription.", "operationId": "DeleteWebhookSubscription", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "No Content", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "webhooks.write" ] } ] } }, "/v1/developer/applications/{applicationId}/webhooks/{subscriptionId}/secret": { "post": { "tags": [ "Webhooks" ], "summary": "Rotate webhook signing secret; returned once", "description": "If-Match required. Immediate cutover for new attempts; already claimed attempts may use the old version. No secret retrieval endpoint. Receiver must support the transition.", "operationId": "RotateWebhookSecret", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookSecretResult" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "webhooks.write" ] } ] } }, "/v1/developer/applications/{applicationId}/webhooks/{subscriptionId}/deliveries": { "get": { "tags": [ "Webhooks" ], "summary": "Read delivery states with bounded cursor pagination", "description": "limit 1–100, default 25; cursor = page.nextCursor. Descending delivery ID. Metadata only; no payloads, secrets or receiver response bodies.", "operationId": "ListWebhookDeliveries", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookDeliveries" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "webhooks.read" ] } ] } }, "/v1/developer/applications/{applicationId}/webhooks/{subscriptionId}/deliveries/{deliveryId}/attempts": { "get": { "tags": [ "Webhooks" ], "summary": "Read sanitized delivery attempt history", "description": "At most 32 attempts: eight per cycle and up to three manual retry cycles. No headers or receiver body stored.", "operationId": "ListWebhookAttempts", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "deliveryId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookAttempts" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "webhooks.read" ] } ] } }, "/v1/developer/applications/{applicationId}/webhooks/{subscriptionId}/deliveries/{deliveryId}/retry": { "post": { "tags": [ "Webhooks" ], "summary": "Retry a failed delivery with the same event and delivery IDs", "description": "Only failed deliveries for an active owned application/subscription; at most three manual cycles. Concurrent or repeated retries return conflict once scheduled. No arbitrary historical replay.", "operationId": "RetryWebhookDelivery", "parameters": [ { "name": "applicationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "subscriptionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "deliveryId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "No Content", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } } }, "400": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "401": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "403": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "404": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "409": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "413": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "415": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "422": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "428": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "429": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } }, "Retry-After": { "description": "Seconds until another attempt", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "500": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } }, "503": { "description": "Problem Details; code and requestId identify the error.", "headers": { "X-Request-Id": { "description": "Server-generated request correlation identifier", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "required": [ "type", "title", "status", "code", "requestId", "detail", "traceId" ], "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "code": { "type": "string" }, "requestId": { "type": "string" }, "detail": { "type": [ "null", "string" ] }, "traceId": { "type": [ "null", "string" ] } } } } } } }, "security": [ { "aniyori": [ "webhooks.write" ] } ] } } }, "components": { "schemas": { "AnimeDetail": { "required": [ "id", "title", "format", "status", "episodes", "year", "season", "startDate", "endDate", "externalIds", "revision", "updatedAt" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "$ref": "#/components/schemas/AnimeTitles" }, "format": { "type": "string" }, "status": { "type": "string" }, "episodes": { "type": [ "null", "integer" ], "format": "int32" }, "year": { "type": [ "null", "integer" ], "format": "int32" }, "season": { "type": [ "null", "string" ] }, "startDate": { "type": [ "null", "string" ], "format": "date" }, "endDate": { "type": [ "null", "string" ], "format": "date" }, "externalIds": { "type": "array", "items": { "$ref": "#/components/schemas/ExternalIdentifier" } }, "revision": { "type": "integer", "format": "int64" }, "updatedAt": { "type": "string", "format": "date-time" }, "metadata": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/AnimeMetadata" } ] } } }, "AnimeImageResource": { "required": [ "kind", "language", "url", "width", "height", "license", "attribution" ], "type": "object", "properties": { "kind": { "type": "string" }, "language": { "type": "string" }, "url": { "type": "string" }, "width": { "type": [ "null", "integer" ], "format": "int32" }, "height": { "type": [ "null", "integer" ], "format": "int32" }, "license": { "type": "string" }, "attribution": { "type": "string" } } }, "AnimeMetadata": { "required": [ "synopsis", "durationMinutes", "source", "ageRating", "images", "genres", "studios" ], "type": "object", "properties": { "synopsis": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/SynopsisResource" } ] }, "durationMinutes": { "type": [ "null", "integer" ], "format": "int32" }, "source": { "type": "string" }, "ageRating": { "type": "string" }, "images": { "type": "array", "items": { "$ref": "#/components/schemas/AnimeImageResource" } }, "genres": { "type": "array", "items": { "$ref": "#/components/schemas/TaxonomyResource" } }, "studios": { "type": "array", "items": { "$ref": "#/components/schemas/TaxonomyResource" } } } }, "AnimePage": { "required": [ "items", "page" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AnimeSummary" } }, "page": { "$ref": "#/components/schemas/PageInfo" } } }, "AnimePremiere": { "required": [ "anime", "premiereDate", "status" ], "type": "object", "properties": { "anime": { "$ref": "#/components/schemas/EpisodeAnime" }, "premiereDate": { "type": "string", "format": "date" }, "status": { "type": "string" } } }, "AnimeRelationResource": { "required": [ "id", "kind", "title" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "kind": { "type": "string" }, "title": { "type": "string" } } }, "AnimeRelations": { "required": [ "items", "truncated" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AnimeRelationResource" } }, "truncated": { "type": "boolean" } } }, "AnimeSearchItem": { "required": [ "id", "title", "alternativeTitles", "format", "status", "episodes", "year", "season" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "alternativeTitles": { "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "status": { "type": "string" }, "episodes": { "type": [ "null", "integer" ], "format": "int32" }, "year": { "type": [ "null", "integer" ], "format": "int32" }, "season": { "type": [ "null", "string" ] } } }, "AnimeSearchPage": { "required": [ "items", "page", "found", "truncated", "facets" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AnimeSearchItem" } }, "page": { "$ref": "#/components/schemas/PageInfo" }, "found": { "type": "integer", "format": "int64" }, "truncated": { "type": "boolean" }, "facets": { "type": "array", "items": { "$ref": "#/components/schemas/SearchFacet" } } } }, "AnimeSummary": { "required": [ "id", "title", "format", "status", "episodes", "year", "season" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "$ref": "#/components/schemas/AnimeTitles" }, "format": { "type": "string" }, "status": { "type": "string" }, "episodes": { "type": [ "null", "integer" ], "format": "int32" }, "year": { "type": [ "null", "integer" ], "format": "int32" }, "season": { "type": [ "null", "string" ] }, "poster": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/AnimeImageResource" } ] } } }, "AnimeTitles": { "required": [ "preferred", "alternatives" ], "type": "object", "properties": { "preferred": { "type": "string" }, "alternatives": { "type": "array", "items": { "$ref": "#/components/schemas/LocalizedTitle" } } } }, "ApiKeyMetadata": { "required": [ "id", "applicationId", "name", "keyPrefix", "environment", "scopes", "createdAt", "expiresAt", "lastUsedAt", "revokedAt" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "applicationId": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "keyPrefix": { "type": "string" }, "environment": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": [ "null", "string" ], "format": "date-time" }, "lastUsedAt": { "type": [ "null", "string" ], "format": "date-time" }, "revokedAt": { "type": [ "null", "string" ], "format": "date-time" } } }, "ApiKeys": { "required": [ "items", "page" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ApiKeyMetadata" } }, "page": { "$ref": "#/components/schemas/PageInfo" } } }, "ApplicationUsage": { "required": [ "requestsToday", "requestsThisMonth", "errorsThisMonth", "asOf", "retentionDays" ], "type": "object", "properties": { "requestsToday": { "type": "integer", "format": "int64" }, "requestsThisMonth": { "type": "integer", "format": "int64" }, "errorsThisMonth": { "type": "integer", "format": "int64" }, "asOf": { "type": "string", "format": "date-time" }, "retentionDays": { "type": "integer", "format": "int32" } } }, "CreateApiKeyInput": { "required": [ "name", "scopes", "expiresAt" ], "type": "object", "properties": { "name": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "expiresAt": { "type": [ "null", "string" ], "format": "date-time" } }, "additionalProperties": false }, "CreateApplicationInput": { "required": [ "name", "slug", "description", "environment" ], "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "description": { "type": [ "null", "string" ] }, "environment": { "type": "string" } }, "additionalProperties": false }, "CreatedApiKey": { "required": [ "credential", "key" ], "type": "object", "properties": { "credential": { "$ref": "#/components/schemas/ApiKeyMetadata" }, "key": { "type": "string" } } }, "CreateWebhookInput": { "required": [ "name", "url", "events" ], "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string" }, "events": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "DeveloperApp": { "required": [ "id", "publicId", "name", "slug", "description", "environment", "status", "createdAt", "updatedAt", "revision" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "publicId": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "slug": { "type": "string" }, "description": { "type": [ "null", "string" ] }, "environment": { "type": "string" }, "status": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "revision": { "type": "integer", "format": "int64" } } }, "DeveloperApps": { "required": [ "items", "page" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/DeveloperApp" } }, "page": { "$ref": "#/components/schemas/PageInfo" } } }, "EpisodeAnime": { "required": [ "id", "title", "format" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "format": { "type": "string" } } }, "EpisodePage": { "required": [ "items", "page", "window" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/EpisodeResource" } }, "page": { "$ref": "#/components/schemas/PageInfo" }, "window": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/ReleaseWindow" } ] } } }, "EpisodeResource": { "required": [ "id", "anime", "number", "title", "titleLanguage", "status", "scheduledAt", "releasedAt", "revision", "updatedAt" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "anime": { "$ref": "#/components/schemas/EpisodeAnime" }, "number": { "type": "integer", "format": "int32" }, "title": { "type": [ "null", "string" ] }, "titleLanguage": { "type": [ "null", "string" ] }, "status": { "type": "string" }, "scheduledAt": { "type": [ "null", "string" ], "format": "date-time" }, "releasedAt": { "type": [ "null", "string" ], "format": "date-time" }, "revision": { "type": "integer", "format": "int64" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "ExternalIdentifier": { "required": [ "provider", "externalId", "url" ], "type": "object", "properties": { "provider": { "type": "string" }, "externalId": { "type": "string" }, "url": { "type": [ "null", "string" ] } } }, "ExternalResolution": { "required": [ "id", "resource", "url" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "resource": { "type": "string" }, "url": { "type": "string" } } }, "GenrePage": { "required": [ "items", "page" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/TaxonomyResource" } }, "page": { "$ref": "#/components/schemas/PageInfo" } } }, "JsonElement": { }, "LibraryAnime": { "required": [ "id", "title", "image", "episodes", "format" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "image": { "type": [ "null", "string" ] }, "episodes": { "type": [ "null", "integer" ], "format": "int32" }, "format": { "type": "string" } } }, "LibraryItem": { "required": [ "anime", "status", "episodesWatched", "score", "rewatchCount", "startedAt", "completedAt", "updatedAt", "revision" ], "type": "object", "properties": { "anime": { "$ref": "#/components/schemas/LibraryAnime" }, "status": { "type": "string" }, "episodesWatched": { "type": "integer", "format": "int32" }, "score": { "type": [ "null", "integer" ], "format": "int32" }, "rewatchCount": { "type": "integer", "format": "int32" }, "startedAt": { "type": [ "null", "string" ], "format": "date-time" }, "completedAt": { "type": [ "null", "string" ], "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "revision": { "type": "integer", "format": "int64" } } }, "LibraryPage": { "required": [ "items", "nextCursor" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/LibraryItem" } }, "nextCursor": { "type": [ "null", "string" ] } } }, "LocalizedTitle": { "required": [ "language", "kind", "value" ], "type": "object", "properties": { "language": { "type": "string" }, "kind": { "type": "string" }, "value": { "type": "string" } } }, "MeProfile": { "required": [ "id", "username", "displayName", "avatar", "bio", "preferredLanguage", "preferredRegion", "createdAt", "revision" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "username": { "type": "string" }, "displayName": { "type": "string" }, "avatar": { "type": [ "null", "string" ] }, "bio": { "type": [ "null", "string" ] }, "preferredLanguage": { "type": "string" }, "preferredRegion": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "revision": { "type": "integer", "format": "int64" } } }, "PageInfo": { "required": [ "nextCursor" ], "type": "object", "properties": { "nextCursor": { "type": [ "null", "string" ] } } }, "PlatformInfo": { "required": [ "name", "apiVersion", "documentation" ], "type": "object", "properties": { "name": { "type": "string" }, "apiVersion": { "type": "string" }, "documentation": { "type": "string" } } }, "PremierePage": { "required": [ "items", "page", "window" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AnimePremiere" } }, "page": { "$ref": "#/components/schemas/PageInfo" }, "window": { "$ref": "#/components/schemas/ReleaseWindow" } } }, "ProblemDetails": { "type": "object", "properties": { "type": { "type": [ "null", "string" ] }, "title": { "type": [ "null", "string" ] }, "status": { "type": [ "null", "integer" ], "format": "int32" }, "detail": { "type": [ "null", "string" ] }, "instance": { "type": [ "null", "string" ] } } }, "ReleaseWindow": { "required": [ "from", "to" ], "type": "object", "properties": { "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" } } }, "RenameApiKeyInput": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string" } }, "additionalProperties": false }, "RequestLogResource": { "required": [ "requestId", "method", "operation", "statusCode", "durationMs", "timestamp", "environment" ], "type": "object", "properties": { "requestId": { "type": "string" }, "method": { "type": "string" }, "operation": { "type": "string" }, "statusCode": { "type": "integer", "format": "int32" }, "durationMs": { "type": "number", "format": "double" }, "timestamp": { "type": "string", "format": "date-time" }, "environment": { "type": "string" } } }, "RequestLogs": { "required": [ "items", "page" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/RequestLogResource" } }, "page": { "$ref": "#/components/schemas/PageInfo" } } }, "SearchFacet": { "required": [ "field", "values" ], "type": "object", "properties": { "field": { "type": "string" }, "values": { "type": "array", "items": { "$ref": "#/components/schemas/SearchFacetValue" } } } }, "SearchFacetValue": { "required": [ "value", "count" ], "type": "object", "properties": { "value": { "type": "string" }, "count": { "type": "integer", "format": "int64" } } }, "StudioPage": { "required": [ "items", "page" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/TaxonomyResource" } }, "page": { "$ref": "#/components/schemas/PageInfo" } } }, "SynopsisResource": { "required": [ "language", "value" ], "type": "object", "properties": { "language": { "type": "string" }, "value": { "type": "string" } } }, "TaxonomyResource": { "required": [ "id", "slug", "name" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string" }, "name": { "type": "string" } } }, "UpdateApplicationInput": { "required": [ "name", "description" ], "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": [ "null", "string" ] } }, "additionalProperties": false }, "UpdateWebhookInput": { "required": [ "name", "events", "enabled" ], "type": "object", "properties": { "name": { "type": "string" }, "events": { "type": "array", "items": { "type": "string" } }, "enabled": { "type": "boolean" } }, "additionalProperties": false }, "WebhookAttemptResource": { "required": [ "number", "startedAt", "completedAt", "statusCode", "errorCode", "durationMs", "secretVersion" ], "type": "object", "properties": { "number": { "type": "integer", "format": "int32" }, "startedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": [ "null", "string" ], "format": "date-time" }, "statusCode": { "type": [ "null", "integer" ], "format": "int32" }, "errorCode": { "type": [ "null", "string" ] }, "durationMs": { "type": [ "null", "number" ], "format": "double" }, "secretVersion": { "type": "integer", "format": "int32" } } }, "WebhookAttempts": { "required": [ "items" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/WebhookAttemptResource" } } } }, "WebhookDeliveries": { "required": [ "items", "page" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/WebhookDeliveryResource" } }, "page": { "$ref": "#/components/schemas/PageInfo" } } }, "WebhookDeliveryResource": { "required": [ "id", "eventId", "type", "status", "attempts", "replayCount", "createdAt", "availableAt", "completedAt" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "eventId": { "type": "string", "format": "uuid" }, "type": { "type": "string" }, "status": { "type": "string" }, "attempts": { "type": "integer", "format": "int32" }, "replayCount": { "type": "integer", "format": "int32" }, "createdAt": { "type": "string", "format": "date-time" }, "availableAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": [ "null", "string" ], "format": "date-time" } } }, "WebhookSecretResult": { "required": [ "subscription", "secret" ], "type": "object", "properties": { "subscription": { "$ref": "#/components/schemas/WebhookSubscriptionResource" }, "secret": { "type": "string" } } }, "WebhookSubscriptionResource": { "required": [ "id", "applicationId", "name", "url", "events", "status", "secretVersion", "startSequence", "revision", "createdAt", "updatedAt" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "applicationId": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "url": { "type": "string" }, "events": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string" }, "secretVersion": { "type": "integer", "format": "int32" }, "startSequence": { "type": "integer", "format": "int64" }, "revision": { "type": "integer", "format": "int64" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "WebhookSubscriptions": { "required": [ "items", "page" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/WebhookSubscriptionResource" } }, "page": { "$ref": "#/components/schemas/PageInfo" } } } }, "securitySchemes": { "apiKey": { "type": "http", "description": "Application API key. Never send it in a query string. Environment must match this deployment.", "scheme": "bearer", "bearerFormat": "ani_test_… or ani_live_…" }, "aniyori": { "type": "oauth2", "description": "Aniyori Identity. Authorization Code with PKCE S256. No client secret in the browser.", "flows": { "clientCredentials": { "tokenUrl": "https://auth.aniyori.cz/connect/token", "scopes": { "anime.read": "Application catalog access", "search.read": "Search canonical anime" } }, "authorizationCode": { "authorizationUrl": "https://auth.aniyori.cz/connect/authorize", "tokenUrl": "https://auth.aniyori.cz/connect/token", "scopes": { "anime.read": "Read catalog", "search.read": "Search canonical anime", "developers.read": "Read own developer resources", "developers.write": "Manage own developer resources", "openid": "Identity", "profile": "Username", "profile.read": "Read own profile", "profile.write": "Edit own profile", "library.read": "Read own library", "library.write": "Edit own library", "ratings.read": "Read ratings", "ratings.write": "Edit own rating", "webhooks.read": "Read own webhook subscriptions and delivery attempts", "webhooks.write": "Manage own webhook subscriptions and signing secrets" } } } } } }, "tags": [ { "name": "Search" }, { "name": "Aniyori" }, { "name": "Catalog" }, { "name": "Catalog taxonomy" }, { "name": "Releases and schedules" }, { "name": "Me" }, { "name": "Library" }, { "name": "Developer applications" }, { "name": "Webhooks" } ] }