Summary
Standardize how readers request and negotiate content format (markdown, HTML, structured blocks) from content endpoints.
Context
Currently the spec shows example responses in various formats (JSON with html/md fields) but doesn't define a standard negotiation mechanism (e.g., Accept headers, format query params, or a dedicated negotiation endpoint).
Responsibilities
- Define an Accept header value (e.g.,
application/vnd.ope.content+json)
- Specify format query parameter behavior
- Document the response schema for each format type
- Ensure consistency with existing batch endpoint format negotiation
Related
Spec sections: 10 Content Retrieval, 10.2 Batch Retrieval, Future Work
Summary
Standardize how readers request and negotiate content format (markdown, HTML, structured blocks) from content endpoints.
Context
Currently the spec shows example responses in various formats (JSON with html/md fields) but doesn't define a standard negotiation mechanism (e.g., Accept headers, format query params, or a dedicated negotiation endpoint).
Responsibilities
application/vnd.ope.content+json)Related
Spec sections: 10 Content Retrieval, 10.2 Batch Retrieval, Future Work