{ "openapi": "3.1.1", "info": { "title": "Stage 1 Professional Knowledge REST API — minimum freeze proposal", "version": "0.4.0-19-row-minimum-draft", "description": "19-row baseline aligned proposal. 16 distinct resource records plus three embedded assertions, repeated by ID where self-contained responses require. Fictional Avery examples only. No implementation, real source-use or release grant. Optional media must not block the text minimum." }, "servers": [ { "url": "https://portfolio.example", "description": "Reserved fictional design origin; no endpoint is live." } ], "security": [], "paths": { "/api/v1/profile": { "get": { "parameters": [], "operationId": "getProfile", "summary": "Professional identity and links to the remaining resources.", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProfileResponse" }, "examples": { "profile": { "value": { "data": { "id": "pro_syn001", "type": "profile", "revision": 1, "name": "Avery Example (fictional)", "experience_ids": [ "exp_syn001", "exp_syn002", "exp_syn003" ], "capability_ids": [ "cap_syn001", "cap_syn002", "cap_syn003" ], "sources": [ { "id": "src_syn001", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] }, { "id": "src_syn002", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] }, { "id": "src_syn003", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Wholly fictional fixture, not Jason Sonderman career data." } ] }, "meta": { "api_version": "1", "revision": "r_bb72fbfe50054b511c8c7046eda23e48e7f7939b05ab87e55dc758c2dfb61424", "coverage": "SYNTHETIC ONLY: Avery Example and three fictional work contexts/studies. Not Jason Sonderman professional facts; no real content grants or image bytes.", "example": true }, "links": { "self": "/api/v1/profile", "profile": "/api/v1/profile", "experience": "/api/v1/experience", "projects": "/api/v1/projects", "capabilities": "/api/v1/capabilities", "openapi": "/api/openapi.json" } } } } } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } }, "head": { "parameters": [], "operationId": "getProfileHeaders", "summary": "GET-equivalent headers without body", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } } } }, "options": { "operationId": "getProfileOptions", "summary": "Anonymous read-only preflight; no resource-existence disclosure", "responses": { "204": { "description": "No body; route-pattern preflight does not inspect whether an ID is published.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Access-Control-Allow-Methods": { "schema": { "const": "GET, HEAD, OPTIONS", "type": "string" } }, "Access-Control-Allow-Headers": { "schema": { "const": "Accept", "type": "string" } }, "Access-Control-Expose-Headers": { "schema": { "const": "Retry-After, X-Knowledge-Revision", "type": "string" } } } } }, "parameters": [] } }, "/api/v1/experience": { "get": { "parameters": [], "operationId": "listExperience", "summary": "Complete reviewed Stage 1 role/experience collection.", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExperienceListResponse" }, "examples": { "experience": { "value": { "data": [ { "id": "exp_syn001", "type": "experience", "revision": 1, "organization": "Fictional Organization 1", "work_scope": "Fictional design contributor", "projects": [ { "id": "prj_syn001", "url": "/api/v1/projects/prj_syn001" } ], "sources": [ { "id": "src_syn001", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] }, { "id": "exp_syn002", "type": "experience", "revision": 1, "organization": "Fictional Organization 2", "work_scope": "Fictional design contributor", "projects": [ { "id": "prj_syn002", "url": "/api/v1/projects/prj_syn002" } ], "sources": [ { "id": "src_syn002", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] }, { "id": "exp_syn003", "type": "experience", "revision": 1, "organization": "Fictional Organization 3", "work_scope": "Fictional design contributor", "projects": [ { "id": "prj_syn003", "url": "/api/v1/projects/prj_syn003" } ], "sources": [ { "id": "src_syn003", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "meta": { "api_version": "1", "revision": "r_bb72fbfe50054b511c8c7046eda23e48e7f7939b05ab87e55dc758c2dfb61424", "coverage": "SYNTHETIC ONLY: Avery Example and three fictional work contexts/studies. Not Jason Sonderman professional facts; no real content grants or image bytes.", "example": true }, "links": { "self": "/api/v1/experience", "profile": "/api/v1/profile", "experience": "/api/v1/experience", "projects": "/api/v1/projects", "capabilities": "/api/v1/capabilities", "openapi": "/api/openapi.json" } } } } } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "description": "Scoped work contexts, not confirmed employment titles or chronology. No title, dates, credentials or contact fields supplied by this minimum." }, "head": { "parameters": [], "operationId": "listExperienceHeaders", "summary": "GET-equivalent headers without body", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } } }, "description": "Scoped work contexts, not confirmed employment titles or chronology. No title, dates, credentials or contact fields supplied by this minimum." }, "options": { "operationId": "listExperienceOptions", "summary": "Anonymous read-only preflight; no resource-existence disclosure", "responses": { "204": { "description": "No body; route-pattern preflight does not inspect whether an ID is published.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Access-Control-Allow-Methods": { "schema": { "const": "GET, HEAD, OPTIONS", "type": "string" } }, "Access-Control-Allow-Headers": { "schema": { "const": "Accept", "type": "string" } }, "Access-Control-Expose-Headers": { "schema": { "const": "Retry-After, X-Knowledge-Revision", "type": "string" } } } } }, "parameters": [], "description": "Scoped work contexts, not confirmed employment titles or chronology. No title, dates, credentials or contact fields supplied by this minimum." } }, "/api/v1/projects": { "get": { "parameters": [], "operationId": "listProjects", "summary": "Complete small Stage 1 project/case-study collection, including evidence and media metadata.", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectListResponse" }, "examples": { "projects": { "value": { "data": [ { "id": "prj_syn001", "type": "project", "revision": 1, "title": "Fictional Service Operations Study", "published_slug": "synthetic-study-1", "experience_ids": [ "exp_syn001" ], "assertions": [ { "key": "SYN-ASSERTION-001", "revision": 1, "text": "Avery Example explored a fictional design question in scenario 1.", "kinds": [ "interpretation" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 1.", "authority_limits": null }, "verification": "unverified", "source_ids": [ "src_syn001" ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "evidence": [ { "id": "evd_syn001", "type": "evidence", "revision": 1, "kind": "account", "supports_assertion_keys": [ "SYN-ASSERTION-001" ], "support_assessment": "illustrates_only", "source_ids": [ "src_syn001" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 1.", "authority_limits": null }, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "sources": [ { "id": "src_syn001", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ], "media": [] }, { "id": "prj_syn002", "type": "project", "revision": 1, "title": "Fictional Interface Library Study", "published_slug": "synthetic-study-2", "experience_ids": [ "exp_syn002" ], "assertions": [ { "key": "SYN-ASSERTION-002", "revision": 1, "text": "Avery Example explored a fictional design question in scenario 2.", "kinds": [ "interpretation" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 2.", "authority_limits": null }, "verification": "unverified", "source_ids": [ "src_syn002" ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "evidence": [ { "id": "evd_syn002", "type": "evidence", "revision": 1, "kind": "account", "supports_assertion_keys": [ "SYN-ASSERTION-002" ], "support_assessment": "illustrates_only", "source_ids": [ "src_syn002" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 2.", "authority_limits": null }, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "sources": [ { "id": "src_syn002", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ], "media": [] }, { "id": "prj_syn003", "type": "project", "revision": 1, "title": "Fictional Training Workflow Study", "published_slug": "synthetic-study-3", "experience_ids": [ "exp_syn003" ], "assertions": [ { "key": "SYN-ASSERTION-003", "revision": 1, "text": "Avery Example explored a fictional design question in scenario 3.", "kinds": [ "interpretation" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 3.", "authority_limits": null }, "verification": "unverified", "source_ids": [ "src_syn003" ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "evidence": [ { "id": "evd_syn003", "type": "evidence", "revision": 1, "kind": "account", "supports_assertion_keys": [ "SYN-ASSERTION-003" ], "support_assessment": "illustrates_only", "source_ids": [ "src_syn003" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 3.", "authority_limits": null }, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "sources": [ { "id": "src_syn003", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ], "media": [] } ], "meta": { "api_version": "1", "revision": "r_bb72fbfe50054b511c8c7046eda23e48e7f7939b05ab87e55dc758c2dfb61424", "coverage": "SYNTHETIC ONLY: Avery Example and three fictional work contexts/studies. Not Jason Sonderman professional facts; no real content grants or image bytes.", "example": true }, "links": { "self": "/api/v1/projects", "profile": "/api/v1/profile", "experience": "/api/v1/experience", "projects": "/api/v1/projects", "capabilities": "/api/v1/capabilities", "openapi": "/api/openapi.json" } } }, "empty-projects": { "value": { "data": [], "meta": { "api_version": "1", "revision": "r_bb72fbfe50054b511c8c7046eda23e48e7f7939b05ab87e55dc758c2dfb61424", "coverage": "SYNTHETIC ONLY: Avery Example and three fictional work contexts/studies. Not Jason Sonderman professional facts; no real content grants or image bytes.", "example": true }, "links": { "self": "/api/v1/projects", "profile": "/api/v1/profile", "experience": "/api/v1/experience", "projects": "/api/v1/projects", "capabilities": "/api/v1/capabilities", "openapi": "/api/openapi.json" } } } } } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "unsupported-query": { "value": { "type": "about:blank", "title": "Bad Request", "status": 400, "code": "invalid_request", "detail": "This minimum API does not support query parameters." } } } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "unavailable": { "value": { "type": "about:blank", "title": "Service Unavailable", "status": 503, "code": "temporarily_unavailable", "detail": "The requested information is temporarily unavailable." } } } } } } }, "description": "Three selected study accounts. Exact assertions, account-only evidence and human-readable source labels; no outcome metrics or full narrative import. Optional media is empty in baseline." }, "head": { "parameters": [], "operationId": "listProjectsHeaders", "summary": "GET-equivalent headers without body", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } } }, "description": "Three selected study accounts. Exact assertions, account-only evidence and human-readable source labels; no outcome metrics or full narrative import. Optional media is empty in baseline." }, "options": { "operationId": "listProjectsOptions", "summary": "Anonymous read-only preflight; no resource-existence disclosure", "responses": { "204": { "description": "No body; route-pattern preflight does not inspect whether an ID is published.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Access-Control-Allow-Methods": { "schema": { "const": "GET, HEAD, OPTIONS", "type": "string" } }, "Access-Control-Allow-Headers": { "schema": { "const": "Accept", "type": "string" } }, "Access-Control-Expose-Headers": { "schema": { "const": "Retry-After, X-Knowledge-Revision", "type": "string" } } } } }, "parameters": [], "description": "Three selected study accounts. Exact assertions, account-only evidence and human-readable source labels; no outcome metrics or full narrative import. Optional media is empty in baseline." } }, "/api/v1/projects/{id}": { "get": { "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^prj_[a-z0-9]{2,48}$" }, "description": "Stable eligible public ID; not a filename, source URL or repository path." } ], "operationId": "getProject", "summary": "One selected study with bounded attribution, account evidence and source labels.", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectResponse" }, "examples": { "project-prj_syn001": { "value": { "data": { "id": "prj_syn001", "type": "project", "revision": 1, "title": "Fictional Service Operations Study", "published_slug": "synthetic-study-1", "experience_ids": [ "exp_syn001" ], "assertions": [ { "key": "SYN-ASSERTION-001", "revision": 1, "text": "Avery Example explored a fictional design question in scenario 1.", "kinds": [ "interpretation" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 1.", "authority_limits": null }, "verification": "unverified", "source_ids": [ "src_syn001" ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "evidence": [ { "id": "evd_syn001", "type": "evidence", "revision": 1, "kind": "account", "supports_assertion_keys": [ "SYN-ASSERTION-001" ], "support_assessment": "illustrates_only", "source_ids": [ "src_syn001" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 1.", "authority_limits": null }, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "sources": [ { "id": "src_syn001", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ], "media": [] }, "meta": { "api_version": "1", "revision": "r_bb72fbfe50054b511c8c7046eda23e48e7f7939b05ab87e55dc758c2dfb61424", "coverage": "SYNTHETIC ONLY: Avery Example and three fictional work contexts/studies. Not Jason Sonderman professional facts; no real content grants or image bytes.", "example": true }, "links": { "self": "/api/v1/projects/prj_syn001", "profile": "/api/v1/profile", "experience": "/api/v1/experience", "projects": "/api/v1/projects", "capabilities": "/api/v1/capabilities", "openapi": "/api/openapi.json" } } }, "project-prj_syn002": { "value": { "data": { "id": "prj_syn002", "type": "project", "revision": 1, "title": "Fictional Interface Library Study", "published_slug": "synthetic-study-2", "experience_ids": [ "exp_syn002" ], "assertions": [ { "key": "SYN-ASSERTION-002", "revision": 1, "text": "Avery Example explored a fictional design question in scenario 2.", "kinds": [ "interpretation" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 2.", "authority_limits": null }, "verification": "unverified", "source_ids": [ "src_syn002" ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "evidence": [ { "id": "evd_syn002", "type": "evidence", "revision": 1, "kind": "account", "supports_assertion_keys": [ "SYN-ASSERTION-002" ], "support_assessment": "illustrates_only", "source_ids": [ "src_syn002" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 2.", "authority_limits": null }, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "sources": [ { "id": "src_syn002", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ], "media": [] }, "meta": { "api_version": "1", "revision": "r_bb72fbfe50054b511c8c7046eda23e48e7f7939b05ab87e55dc758c2dfb61424", "coverage": "SYNTHETIC ONLY: Avery Example and three fictional work contexts/studies. Not Jason Sonderman professional facts; no real content grants or image bytes.", "example": true }, "links": { "self": "/api/v1/projects/prj_syn002", "profile": "/api/v1/profile", "experience": "/api/v1/experience", "projects": "/api/v1/projects", "capabilities": "/api/v1/capabilities", "openapi": "/api/openapi.json" } } }, "project-prj_syn003": { "value": { "data": { "id": "prj_syn003", "type": "project", "revision": 1, "title": "Fictional Training Workflow Study", "published_slug": "synthetic-study-3", "experience_ids": [ "exp_syn003" ], "assertions": [ { "key": "SYN-ASSERTION-003", "revision": 1, "text": "Avery Example explored a fictional design question in scenario 3.", "kinds": [ "interpretation" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 3.", "authority_limits": null }, "verification": "unverified", "source_ids": [ "src_syn003" ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "evidence": [ { "id": "evd_syn003", "type": "evidence", "revision": 1, "kind": "account", "supports_assertion_keys": [ "SYN-ASSERTION-003" ], "support_assessment": "illustrates_only", "source_ids": [ "src_syn003" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 3.", "authority_limits": null }, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "sources": [ { "id": "src_syn003", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ], "media": [] }, "meta": { "api_version": "1", "revision": "r_bb72fbfe50054b511c8c7046eda23e48e7f7939b05ab87e55dc758c2dfb61424", "coverage": "SYNTHETIC ONLY: Avery Example and three fictional work contexts/studies. Not Jason Sonderman professional facts; no real content grants or image bytes.", "example": true }, "links": { "self": "/api/v1/projects/prj_syn003", "profile": "/api/v1/profile", "experience": "/api/v1/experience", "projects": "/api/v1/projects", "capabilities": "/api/v1/capabilities", "openapi": "/api/openapi.json" } } } } } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "unknown-project": { "value": { "type": "about:blank", "title": "Not Found", "status": 404, "code": "not_found", "detail": "No resource is available at this address." } }, "withheld-project": { "value": { "type": "about:blank", "title": "Not Found", "status": 404, "code": "not_found", "detail": "No resource is available at this address." } } } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "description": "Three selected study accounts. Exact assertions, account-only evidence and human-readable source labels; no outcome metrics or full narrative import. Optional media is empty in baseline." }, "head": { "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^prj_[a-z0-9]{2,48}$" }, "description": "Stable eligible public ID; not a filename, source URL or repository path." } ], "operationId": "getProjectHeaders", "summary": "GET-equivalent headers without body", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } } }, "description": "Three selected study accounts. Exact assertions, account-only evidence and human-readable source labels; no outcome metrics or full narrative import. Optional media is empty in baseline." }, "options": { "operationId": "getProjectOptions", "summary": "Anonymous read-only preflight; no resource-existence disclosure", "responses": { "204": { "description": "No body; route-pattern preflight does not inspect whether an ID is published.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Access-Control-Allow-Methods": { "schema": { "const": "GET, HEAD, OPTIONS", "type": "string" } }, "Access-Control-Allow-Headers": { "schema": { "const": "Accept", "type": "string" } }, "Access-Control-Expose-Headers": { "schema": { "const": "Retry-After, X-Knowledge-Revision", "type": "string" } } } } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^prj_[a-z0-9]{2,48}$" }, "description": "Stable eligible public ID; not a filename, source URL or repository path." } ], "description": "Three selected study accounts. Exact assertions, account-only evidence and human-readable source labels; no outcome metrics or full narrative import. Optional media is empty in baseline." } }, "/api/v1/capabilities": { "get": { "parameters": [], "operationId": "listCapabilities", "summary": "Explicit capabilities with eligible project links and embedded qualified evidence.", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CapabilityListResponse" }, "examples": { "capabilities": { "value": { "data": [ { "id": "cap_syn001", "type": "capability", "revision": 1, "name": "Fictional contextual research", "scope": "Fictional illustrative activity", "experience_ids": [ "exp_syn001" ], "projects": [ { "id": "prj_syn001", "url": "/api/v1/projects/prj_syn001" } ], "evidence_links": [ { "evidence_id": "evd_syn001", "assertion_key": "SYN-ASSERTION-001", "assessment": "editorial_association" } ], "assessment_basis": "Synthetic fixture, not professional evidence", "assertions": [ { "key": "SYN-ASSERTION-001", "revision": 1, "text": "Avery Example explored a fictional design question in scenario 1.", "kinds": [ "interpretation" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 1.", "authority_limits": null }, "verification": "unverified", "source_ids": [ "src_syn001" ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "evidence": [ { "id": "evd_syn001", "type": "evidence", "revision": 1, "kind": "account", "supports_assertion_keys": [ "SYN-ASSERTION-001" ], "support_assessment": "illustrates_only", "source_ids": [ "src_syn001" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 1.", "authority_limits": null }, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "sources": [ { "id": "src_syn001", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] }, { "id": "cap_syn002", "type": "capability", "revision": 1, "name": "Fictional token planning", "scope": "Fictional illustrative activity", "experience_ids": [ "exp_syn002" ], "projects": [ { "id": "prj_syn002", "url": "/api/v1/projects/prj_syn002" } ], "evidence_links": [ { "evidence_id": "evd_syn002", "assertion_key": "SYN-ASSERTION-002", "assessment": "editorial_association" } ], "assessment_basis": "Synthetic fixture, not professional evidence", "assertions": [ { "key": "SYN-ASSERTION-002", "revision": 1, "text": "Avery Example explored a fictional design question in scenario 2.", "kinds": [ "interpretation" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 2.", "authority_limits": null }, "verification": "unverified", "source_ids": [ "src_syn002" ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "evidence": [ { "id": "evd_syn002", "type": "evidence", "revision": 1, "kind": "account", "supports_assertion_keys": [ "SYN-ASSERTION-002" ], "support_assessment": "illustrates_only", "source_ids": [ "src_syn002" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 2.", "authority_limits": null }, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "sources": [ { "id": "src_syn002", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] }, { "id": "cap_syn003", "type": "capability", "revision": 1, "name": "Fictional collaborative discovery", "scope": "Fictional illustrative activity", "experience_ids": [ "exp_syn003" ], "projects": [ { "id": "prj_syn003", "url": "/api/v1/projects/prj_syn003" } ], "evidence_links": [ { "evidence_id": "evd_syn003", "assertion_key": "SYN-ASSERTION-003", "assessment": "editorial_association" } ], "assessment_basis": "Synthetic fixture, not professional evidence", "assertions": [ { "key": "SYN-ASSERTION-003", "revision": 1, "text": "Avery Example explored a fictional design question in scenario 3.", "kinds": [ "interpretation" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 3.", "authority_limits": null }, "verification": "unverified", "source_ids": [ "src_syn003" ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "evidence": [ { "id": "evd_syn003", "type": "evidence", "revision": 1, "kind": "account", "supports_assertion_keys": [ "SYN-ASSERTION-003" ], "support_assessment": "illustrates_only", "source_ids": [ "src_syn003" ], "attribution": { "subject": "Avery Example (fictional)", "scope": "synthetic", "contribution_description": "Avery Example explored a fictional design question in scenario 3.", "authority_limits": null }, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "sources": [ { "id": "src_syn003", "type": "source_reference", "revision": 1, "label": "Fictional authoring fixture", "kind": "account", "availability": "not_publicly_available", "public_url": null, "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "qualifications": [ { "kind": "scope", "text": "Synthetic scenario only; no real employer, person, result or independent verification." } ] } ], "meta": { "api_version": "1", "revision": "r_bb72fbfe50054b511c8c7046eda23e48e7f7939b05ab87e55dc758c2dfb61424", "coverage": "SYNTHETIC ONLY: Avery Example and three fictional work contexts/studies. Not Jason Sonderman professional facts; no real content grants or image bytes.", "example": true }, "links": { "self": "/api/v1/capabilities", "profile": "/api/v1/profile", "experience": "/api/v1/experience", "projects": "/api/v1/projects", "capabilities": "/api/v1/capabilities", "openapi": "/api/openapi.json" } } } } } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } }, "head": { "parameters": [], "operationId": "listCapabilitiesHeaders", "summary": "GET-equivalent headers without body", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "X-Knowledge-Revision": { "schema": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "description": "Revision of the public projection this response was built from; always equal to meta.revision in the body." } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } } } }, "options": { "operationId": "listCapabilitiesOptions", "summary": "Anonymous read-only preflight; no resource-existence disclosure", "responses": { "204": { "description": "No body; route-pattern preflight does not inspect whether an ID is published.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Access-Control-Allow-Methods": { "schema": { "const": "GET, HEAD, OPTIONS", "type": "string" } }, "Access-Control-Allow-Headers": { "schema": { "const": "Accept", "type": "string" } }, "Access-Control-Expose-Headers": { "schema": { "const": "Retry-After, X-Knowledge-Revision", "type": "string" } } } } }, "parameters": [] } }, "/api/v1/media/{id}": { "get": { "operationId": "getMedia", "summary": "Direct allowlisted image bytes, no credential or arbitrary path.", "security": [], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^med_[a-z0-9]{2,48}$" }, "description": "Stable eligible public ID; not a filename, source URL or repository path." } ], "responses": { "200": { "description": "Exact current allowlisted image bytes, public and anonymous. Metadata/credit/digest are embedded in eligible Project responses; no JSON content negotiation or redirect.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Content-Length": { "schema": { "type": "integer", "minimum": 1, "maximum": 10485760 } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Content-Disposition": { "schema": { "type": "string" }, "description": "Inline with a sanitized public media-ID filename; never an original repository/editor filename." } }, "content": { "image/jpeg": { "schema": { "type": "string", "format": "binary" } }, "image/png": { "schema": { "type": "string", "format": "binary" } }, "image/webp": { "schema": { "type": "string", "format": "binary" } }, "image/avif": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "unknown-media": { "value": { "type": "about:blank", "title": "Not Found", "status": 404, "code": "not_found", "detail": "No resource is available at this address." } }, "withheld-media": { "value": { "type": "about:blank", "title": "Not Found", "status": 404, "code": "not_found", "detail": "No resource is available at this address." } } } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "description": "Preserved optional image access design. Empty allowlist in the base fixture: all well-formed IDs return the same safe 404. No image bytes or MEDIA002 clearance supplied; 200 binary behavior is conditional on separately approved exact selection." }, "head": { "operationId": "getMediaHeaders", "summary": "GET-equivalent headers without body", "security": [], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^med_[a-z0-9]{2,48}$" }, "description": "Stable eligible public ID; not a filename, source URL or repository path." } ], "responses": { "200": { "description": "Exact allowlisted image bytes. Anonymous read; no auth/signature required. Pinned MIME/hash/length and current eligibility must be checked before release. No live bytes are supplied in this design package.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Content-Length": { "schema": { "type": "integer", "minimum": 1, "maximum": 10485760 } }, "X-Content-Type-Options": { "schema": { "type": "string", "const": "nosniff" } }, "Content-Disposition": { "schema": { "type": "string" }, "description": "Inline with a sanitized public media-ID filename; never an original repository/editor filename." } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } } }, "description": "Preserved optional image access design. Empty allowlist in the base fixture: all well-formed IDs return the same safe 404. No image bytes or MEDIA002 clearance supplied; 200 binary behavior is conditional on separately approved exact selection." }, "options": { "operationId": "getMediaOptions", "summary": "Anonymous read-only preflight; no resource-existence disclosure", "responses": { "204": { "description": "No body; route-pattern preflight does not inspect whether an ID is published.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Access-Control-Allow-Methods": { "schema": { "const": "GET, HEAD, OPTIONS", "type": "string" } }, "Access-Control-Allow-Headers": { "schema": { "const": "Accept", "type": "string" } }, "Access-Control-Expose-Headers": { "schema": { "const": "Retry-After, X-Knowledge-Revision", "type": "string" } } } } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^med_[a-z0-9]{2,48}$" }, "description": "Stable eligible public ID; not a filename, source URL or repository path." } ], "description": "Preserved optional image access design. Empty allowlist in the base fixture: all well-formed IDs return the same safe 404. No image bytes or MEDIA002 clearance supplied; 200 binary behavior is conditional on separately approved exact selection." } }, "/api/openapi.json": { "get": { "parameters": [], "operationId": "getOpenApi", "summary": "Current Stage 1 contract, bootstrapping and renderer input.", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "openapi", "info", "paths", "components" ] } } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } }, "head": { "parameters": [], "operationId": "getOpenApiHeaders", "summary": "GET-equivalent headers without body", "responses": { "200": { "description": "Eligible representation; fictional examples are marked meta.example=true.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "400": { "description": "Bad Request. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "404": { "description": "Not Found. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "405": { "description": "Method Not Allowed. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Allow": { "schema": { "type": "string", "const": "GET, HEAD, OPTIONS" } } } }, "406": { "description": "Not Acceptable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "414": { "description": "URI Too Long. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "429": { "description": "Too Many Requests. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } }, "500": { "description": "Internal Server Error. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } } } }, "503": { "description": "Service Unavailable. Safe details only. Unknown and withheld detail resources share the same 404 representation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Retry-After": { "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Delay in seconds; required for 429, optional when a retry delay is known for 503." } } } } }, "options": { "operationId": "getOpenApiOptions", "summary": "Anonymous read-only preflight; no resource-existence disclosure", "responses": { "204": { "description": "No body; route-pattern preflight does not inspect whether an ID is published.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "No public, browser, CDN or stale-on-error caching for proposed initial data responses." }, "Access-Control-Allow-Origin": { "schema": { "type": "string", "const": "*" } }, "Access-Control-Allow-Methods": { "schema": { "const": "GET, HEAD, OPTIONS", "type": "string" } }, "Access-Control-Allow-Headers": { "schema": { "const": "Accept", "type": "string" } }, "Access-Control-Expose-Headers": { "schema": { "const": "Retry-After, X-Knowledge-Revision", "type": "string" } } } } }, "parameters": [] } } }, "components": { "schemas": { "PublicUrl": { "type": "string", "format": "uri", "pattern": "^https://", "maxLength": 2048 }, "ApiLink": { "type": "string", "format": "uri-reference", "pattern": "^/api/(?:v1(?:/|$)|openapi\\.json$)", "maxLength": 2048 }, "Meta": { "type": "object", "additionalProperties": false, "required": [ "api_version", "revision", "coverage", "example" ], "properties": { "api_version": { "const": "1" }, "revision": { "type": "string", "pattern": "^r_[a-f0-9]{64}$" }, "coverage": { "type": "string", "minLength": 1, "maxLength": 1200 }, "example": { "type": "boolean" } } }, "Problem": { "type": "object", "additionalProperties": false, "required": [ "type", "title", "status", "detail", "code" ], "properties": { "type": { "const": "about:blank" }, "title": { "type": "string", "minLength": 1, "maxLength": 160 }, "status": { "type": "integer", "enum": [ 400, 404, 405, 406, 414, 429, 500, 503 ] }, "detail": { "type": "string", "minLength": 1, "maxLength": 600 }, "code": { "type": "string", "enum": [ "invalid_request", "not_found", "method_not_allowed", "not_acceptable", "rate_limited", "internal_error", "temporarily_unavailable" ] } } }, "Links": { "type": "object", "additionalProperties": false, "properties": { "self": { "$ref": "#/components/schemas/ApiLink" }, "profile": { "type": "string", "const": "/api/v1/profile" }, "experience": { "type": "string", "const": "/api/v1/experience" }, "projects": { "type": "string", "const": "/api/v1/projects" }, "capabilities": { "type": "string", "const": "/api/v1/capabilities" }, "openapi": { "type": "string", "const": "/api/openapi.json" } }, "required": [ "self", "profile", "experience", "projects", "capabilities", "openapi" ] }, "Qualification": { "type": "object", "additionalProperties": false, "properties": { "kind": { "type": "string", "enum": [ "scope", "uncertainty" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "kind", "text" ] }, "Qualifications": { "type": "array", "items": { "$ref": "#/components/schemas/Qualification" }, "maxItems": 20 }, "Attribution": { "type": "object", "additionalProperties": false, "properties": { "subject": { "type": "string", "minLength": 1, "maxLength": 240 }, "scope": { "type": "string", "enum": [ "personal_with_limits", "shared_or_distinct_collaborator_credit_required", "qualified_retrospective_account", "synthetic" ] }, "contribution_description": { "type": "string", "minLength": 1, "maxLength": 2000 }, "authority_limits": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 2000 }, { "type": "null" } ] } }, "required": [ "subject", "scope", "contribution_description", "authority_limits" ] }, "SourceReference": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "pattern": "^src_[a-z0-9]{2,48}$" }, "type": { "const": "source_reference" }, "revision": { "type": "integer", "minimum": 1 }, "label": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "const": "account" }, "availability": { "const": "not_publicly_available" }, "public_url": { "type": "null" }, "qualifications": { "$ref": "#/components/schemas/Qualifications" } }, "required": [ "id", "type", "revision", "label", "kind", "availability", "public_url", "qualifications" ] }, "Assertion": { "type": "object", "additionalProperties": false, "properties": { "key": { "type": "string", "pattern": "^[A-Z0-9][A-Z0-9-]{1,79}$" }, "revision": { "type": "integer", "minimum": 1 }, "text": { "type": "string", "minLength": 1, "maxLength": 2000 }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "personal_contribution", "personal_contribution_with_shared_scope", "interpretation" ] }, "maxItems": 20 }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "verification": { "type": "string", "enum": [ "historically_confirmed_not_independently_verified", "unverified" ] }, "source_ids": { "type": "array", "items": { "type": "string", "pattern": "^src_[a-z0-9]{2,48}$" }, "maxItems": 20 }, "qualifications": { "$ref": "#/components/schemas/Qualifications" } }, "required": [ "key", "revision", "text", "kinds", "attribution", "verification", "source_ids", "qualifications" ] }, "Evidence": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "pattern": "^evd_[a-z0-9]{2,48}$" }, "type": { "const": "evidence" }, "revision": { "type": "integer", "minimum": 1 }, "kind": { "const": "account" }, "supports_assertion_keys": { "type": "array", "items": { "type": "string", "pattern": "^[A-Z0-9][A-Z0-9-]{1,79}$" }, "maxItems": 20 }, "support_assessment": { "type": "string", "enum": [ "supports", "illustrates_only" ] }, "source_ids": { "type": "array", "items": { "type": "string", "pattern": "^src_[a-z0-9]{2,48}$" }, "maxItems": 20 }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "qualifications": { "$ref": "#/components/schemas/Qualifications" } }, "required": [ "id", "type", "revision", "kind", "supports_assertion_keys", "support_assessment", "source_ids", "attribution", "qualifications" ] }, "ProjectLink": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "pattern": "^prj_[a-z0-9]{2,48}$" }, "url": { "$ref": "#/components/schemas/ApiLink" } }, "required": [ "id", "url" ] }, "CapabilityEvidenceLink": { "type": "object", "additionalProperties": false, "properties": { "evidence_id": { "type": "string", "pattern": "^evd_[a-z0-9]{2,48}$" }, "assertion_key": { "type": "string", "pattern": "^[A-Z0-9][A-Z0-9-]{1,79}$" }, "assessment": { "const": "editorial_association" } }, "required": [ "evidence_id", "assertion_key", "assessment" ] }, "Profile": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "pattern": "^pro_[a-z0-9]{2,48}$" }, "type": { "const": "profile" }, "revision": { "type": "integer", "minimum": 1 }, "name": { "type": "string", "minLength": 1, "maxLength": 240 }, "experience_ids": { "type": "array", "items": { "type": "string", "pattern": "^exp_[a-z0-9]{2,48}$" }, "maxItems": 20 }, "capability_ids": { "type": "array", "items": { "type": "string", "pattern": "^cap_[a-z0-9]{2,48}$" }, "maxItems": 20 }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/SourceReference" }, "maxItems": 20 }, "qualifications": { "$ref": "#/components/schemas/Qualifications" } }, "required": [ "id", "type", "revision", "name", "experience_ids", "capability_ids", "sources", "qualifications" ] }, "Experience": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "pattern": "^exp_[a-z0-9]{2,48}$" }, "type": { "const": "experience" }, "revision": { "type": "integer", "minimum": 1 }, "organization": { "type": "string", "minLength": 1, "maxLength": 240 }, "work_scope": { "type": "string", "minLength": 1, "maxLength": 2000 }, "projects": { "type": "array", "items": { "$ref": "#/components/schemas/ProjectLink" }, "maxItems": 20 }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/SourceReference" }, "maxItems": 20 }, "qualifications": { "$ref": "#/components/schemas/Qualifications" } }, "required": [ "id", "type", "revision", "organization", "work_scope", "projects", "sources", "qualifications" ] }, "Media": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "title", "alt_text", "caption", "credit", "rights_notice", "provenance", "media_type", "width", "height", "byte_length", "content_sha256", "project_ids", "evidence_ids", "qualifications", "content_url" ], "properties": { "id": { "type": "string", "pattern": "^med_[a-z0-9]{2,48}$" }, "type": { "const": "media" }, "title": { "type": "string", "minLength": 1, "maxLength": 240 }, "alt_text": { "type": "string", "minLength": 1, "maxLength": 1200 }, "caption": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 1200 }, { "type": "null" } ] }, "credit": { "type": "string", "minLength": 1, "maxLength": 500 }, "rights_notice": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 500 }, { "type": "null" } ] }, "provenance": { "type": "string", "enum": [ "original", "screenshot", "reconstruction", "illustration" ] }, "media_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "image/webp", "image/avif" ] }, "width": { "type": "integer", "minimum": 1, "maximum": 20000 }, "height": { "type": "integer", "minimum": 1, "maximum": 20000 }, "byte_length": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "content_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "project_ids": { "type": "array", "items": { "type": "string", "pattern": "^prj_[a-z0-9]{2,48}$" }, "maxItems": 30 }, "evidence_ids": { "type": "array", "items": { "type": "string", "pattern": "^evd_[a-z0-9]{2,48}$" }, "maxItems": 30 }, "qualifications": { "$ref": "#/components/schemas/Qualifications" }, "content_url": { "$ref": "#/components/schemas/ApiLink", "description": "Direct anonymous GET image bytes at /api/v1/media/{id}; no metadata or /content subresource." } }, "description": "Optional pre-existing Stage 1 image design only; baseline has no media records, metadata placeholders or bytes. Exact clearance and complete measured metadata required before adding an item." }, "Project": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "pattern": "^prj_[a-z0-9]{2,48}$" }, "type": { "const": "project" }, "revision": { "type": "integer", "minimum": 1 }, "title": { "type": "string", "minLength": 1, "maxLength": 240 }, "published_slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 120 }, "experience_ids": { "type": "array", "items": { "type": "string", "pattern": "^exp_[a-z0-9]{2,48}$" }, "maxItems": 20 }, "assertions": { "type": "array", "items": { "$ref": "#/components/schemas/Assertion" }, "maxItems": 20 }, "evidence": { "type": "array", "items": { "$ref": "#/components/schemas/Evidence" }, "maxItems": 20 }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/SourceReference" }, "maxItems": 20 }, "qualifications": { "$ref": "#/components/schemas/Qualifications" }, "media": { "type": "array", "items": { "$ref": "#/components/schemas/Media" }, "maxItems": 10 } }, "required": [ "id", "type", "revision", "title", "published_slug", "experience_ids", "assertions", "evidence", "sources", "qualifications", "media" ] }, "Capability": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "pattern": "^cap_[a-z0-9]{2,48}$" }, "type": { "const": "capability" }, "revision": { "type": "integer", "minimum": 1 }, "name": { "type": "string", "minLength": 1, "maxLength": 240 }, "scope": { "type": "string", "minLength": 1, "maxLength": 2000 }, "experience_ids": { "type": "array", "items": { "type": "string", "pattern": "^exp_[a-z0-9]{2,48}$" }, "maxItems": 20 }, "projects": { "type": "array", "items": { "$ref": "#/components/schemas/ProjectLink" }, "maxItems": 20 }, "evidence_links": { "type": "array", "items": { "$ref": "#/components/schemas/CapabilityEvidenceLink" }, "maxItems": 20 }, "assessment_basis": { "type": "string", "minLength": 1, "maxLength": 2000 }, "assertions": { "type": "array", "items": { "$ref": "#/components/schemas/Assertion" }, "maxItems": 20 }, "evidence": { "type": "array", "items": { "$ref": "#/components/schemas/Evidence" }, "maxItems": 20 }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/SourceReference" }, "maxItems": 20 }, "qualifications": { "$ref": "#/components/schemas/Qualifications" } }, "required": [ "id", "type", "revision", "name", "scope", "experience_ids", "projects", "evidence_links", "assessment_basis", "assertions", "evidence", "sources", "qualifications" ] }, "ProfileResponse": { "type": "object", "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Profile" }, "meta": { "$ref": "#/components/schemas/Meta" }, "links": { "$ref": "#/components/schemas/Links" } }, "required": [ "data", "meta", "links" ] }, "ExperienceListResponse": { "type": "object", "additionalProperties": false, "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Experience" }, "maxItems": 20 }, "meta": { "$ref": "#/components/schemas/Meta" }, "links": { "$ref": "#/components/schemas/Links" } }, "required": [ "data", "meta", "links" ] }, "ProjectListResponse": { "type": "object", "additionalProperties": false, "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Project" }, "maxItems": 20 }, "meta": { "$ref": "#/components/schemas/Meta" }, "links": { "$ref": "#/components/schemas/Links" } }, "required": [ "data", "meta", "links" ] }, "ProjectResponse": { "type": "object", "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/Project" }, "meta": { "$ref": "#/components/schemas/Meta" }, "links": { "$ref": "#/components/schemas/Links" } }, "required": [ "data", "meta", "links" ] }, "CapabilityListResponse": { "type": "object", "additionalProperties": false, "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Capability" }, "maxItems": 30 }, "meta": { "$ref": "#/components/schemas/Meta" }, "links": { "$ref": "#/components/schemas/Links" } }, "required": [ "data", "meta", "links" ] } } }, "x-content-access-policy": { "decision_id": "S00-STAGE1-CONTENT-ACCESS-2026-10-17", "status": "APPROVED_CLASSIFICATION_PRODUCT_POLICY", "excluded_private_classes": [ "JD Pipeline", "JD Seeker", "JD Tracker" ], "excluded_scope": "All associated content, records, metadata, indexes, attachments, summaries and derived information; exclude before discovery/query/projection construction.", "public_images": "Previously protected portfolio images may be intentionally selected for anonymous API access through explicit IDs and an allowlist. No authentication/authorization feature is added at this stage. Applicable third-party rights review still required.", "never_infer_permission": [ "raw editor files", "private documentation", "arbitrary repository assets", "private JD-associated attachments even if image-shaped" ], "implementation": "NOT_AUTHORIZED" }, "x-minimum-contract": { "query_parameters": "None. Unknown or repeated parameters return 400; no filtering/search/cursor/revision selection.", "collections": "Complete reviewed small Stage 1 inventory only; no silent truncation, totals or pagination.", "limits": { "experience": 20, "projects": 20, "capabilities": 30, "project_evidence": 20, "project_media": 10, "json_bytes": 262144, "image_bytes": 10485760, "decoded_image_pixels": 40000000 }, "revisions": "meta.revision = r_ plus SHA-256 of the eligible current projection content using deterministic serialization, including public media metadata only if selected; never hash private input, candidate rejections or raw source files. Record revision is independent. No historical retrieval.", "methods": "GET plus standard HEAD/OPTIONS; all write methods 405.", "cache": "no-store; no ETag, 304, Range, resize or format-conversion contract. Range ignored, whole image 200.", "errors": "RFC9457 JSON Problem Details. Unknown/withheld share 404; invalid query/ID/body 400; unsupported Accept 406; unknown current serving state/integrity 503; safe 500/414/405. Optional 429 with Retry-After only under separately approved abuse policy; no quota or limiter is required for the local slice.", "media_route": "/api/v1/media/{id} returns binary, while metadata is embedded in project.media.", "documentation": "Existing Astro page at /api/docs using locally pinned Swagger UI; no new documentation framework. Readable static quick start and raw OpenAPI remain available.", "status": "PROPOSED_19_ROW_ALIGNMENT_NOT_IMPLEMENTED", "baseline": { "distinct_resources": 16, "embedded_assertions": 3, "by_kind": { "Profile": 1, "Experience": 3, "Project": 3, "Evidence": 3, "Capability": 3, "SourceReference": 3 }, "media_records": 0 }, "media_gate": "Keep seven route shapes. Empty media array/allowlist and safe 404 are sufficient for the base local content demonstration. Actual byte retrieval and any real image are separately gated; optional media must not delay freeze or text-only development/release.", "unsupported_fields": "Omit headline/contact/credentials/employment titles/dates/problem narrative/outcome metrics rather than infer them. Published slug is a selected narrative locator, not a source-access grant or minted canonical Project identity.", "evidence": "Account supports exact selected assertion only; editorial capability association is not proficiency or independent corroboration. Sources are human-readable labels with null public_url in this baseline." } }