AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
GraphQL versioning
How Done Bear evolves the GraphQL schema, marks retiring fields with @deprecated, and sunsets documented fields.
Done Bear does not version the GraphQL URL. There is one schema at https://api.donebear.com/graphql. Breaking changes are announced, then marked, then removed.
Stability
Fields and operations documented on GraphQL reference are stable. Undocumented schema details may change without notice.
Deprecation
When a field is retiring, it stays in the schema with GraphQL @deprecated and a reason that names the replacement.
Example: Task.notes is deprecated. Use Task.description. The CLI flag remains --notes.
Introspect deprecations with:
{
__type(name: "Task") {
fields(includeDeprecated: true) {
name
isDeprecated
deprecationReason
}