{"openapi":"3.1.0","info":{"title":"Citemaker API","version":"0.1.0","description":"Computes real APA 7 / MLA 9 / Chicago 17 (author-date) / IEEE reference-list and in-text citations from structured fields.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://citemaker.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/citemaker/docs"},"termsOfService":"https://connectorbay.com/citemaker/terms"},"servers":[{"url":"https://citemaker.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/citemaker/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/format_citation":{"post":{"operationId":"format_citation","summary":"Compute a real reference-list citation in the given style from structured fields. Returns both a markdown","description":"Compute a real reference-list citation in the given style from structured fields. Returns both a markdown\n    version (italics as *asterisks*) and a plain_text version. Use for \"cite this in APA/MLA/Chicago/IEEE\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"style":{"description":"apa | mla | chicago | ieee","title":"Style","type":"string"},"source_type":{"description":"book | journal_article | website | report | conference_paper","title":"Source Type","type":"string"},"title":{"description":"The work's own title (not the journal/site name).","minLength":1,"title":"Title","type":"string"},"authors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Full names in natural order, e.g. ['Jane Q. Smith', 'Robert Jones']. One entry per author. Omit for an anonymous/no-author work.","title":"Authors"},"year":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Publication year, e.g. 2021. Omit for 'n.d.' (no date).","title":"Year"},"container_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Journal name (journal_article), site name (website), or proceedings/conference name (conference_paper). Not used for book/report.","title":"Container Title"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Publisher name (book/report), or the hosting organization for a website if different from the site name.","title":"Publisher"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Place of publication, e.g. 'New York' or 'Belmont, CA' (used by Chicago and IEEE for books).","title":"City"},"volume":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal volume number.","title":"Volume"},"issue":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal issue number.","title":"Issue"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Page range, e.g. '414-456'.","title":"Pages"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full URL, including scheme.","title":"Url"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A bare DOI (e.g. '10.7560/IC47402') or a full doi.org URL; used instead of url when both a doi and url exist for a journal article.","title":"Doi"},"pub_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full publication date as YYYY-MM-DD or YYYY-MM, for a website or dated post (more precise than year alone).","title":"Pub Date"},"access_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date you accessed a website, as YYYY-MM-DD (MLA/Chicago recommend this for web sources).","title":"Access Date"},"edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Edition, e.g. '2nd' (book/report only).","title":"Edition"},"season":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Issue season, e.g. 'Winter' (Chicago journal articles only).","title":"Season"}},"required":["style","source_type","title"],"title":"format_citationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/format_apa":{"post":{"operationId":"format_apa","summary":"Compute an APA 7th-edition reference-list entry. Convenience wrapper over format_citation(style=\"apa\").","description":"Compute an APA 7th-edition reference-list entry. Convenience wrapper over format_citation(style=\"apa\").","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"source_type":{"description":"book | journal_article | website | report | conference_paper","title":"Source Type","type":"string"},"title":{"description":"The work's own title (not the journal/site name).","minLength":1,"title":"Title","type":"string"},"authors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Full names in natural order, e.g. ['Jane Q. Smith', 'Robert Jones']. One entry per author. Omit for an anonymous/no-author work.","title":"Authors"},"year":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Publication year, e.g. 2021. Omit for 'n.d.' (no date).","title":"Year"},"container_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Journal name (journal_article), site name (website), or proceedings/conference name (conference_paper). Not used for book/report.","title":"Container Title"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Publisher name (book/report), or the hosting organization for a website if different from the site name.","title":"Publisher"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Place of publication, e.g. 'New York' or 'Belmont, CA' (used by Chicago and IEEE for books).","title":"City"},"volume":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal volume number.","title":"Volume"},"issue":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal issue number.","title":"Issue"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Page range, e.g. '414-456'.","title":"Pages"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full URL, including scheme.","title":"Url"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A bare DOI (e.g. '10.7560/IC47402') or a full doi.org URL; used instead of url when both a doi and url exist for a journal article.","title":"Doi"},"pub_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full publication date as YYYY-MM-DD or YYYY-MM, for a website or dated post (more precise than year alone).","title":"Pub Date"},"edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Edition, e.g. '2nd' (book/report only).","title":"Edition"}},"required":["source_type","title"],"title":"format_apaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/format_mla":{"post":{"operationId":"format_mla","summary":"Compute an MLA 9th-edition Works Cited entry. Convenience wrapper over format_citation(style=\"mla\").","description":"Compute an MLA 9th-edition Works Cited entry. Convenience wrapper over format_citation(style=\"mla\").","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"source_type":{"description":"book | journal_article | website | report | conference_paper","title":"Source Type","type":"string"},"title":{"description":"The work's own title (not the journal/site name).","minLength":1,"title":"Title","type":"string"},"authors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Full names in natural order, e.g. ['Jane Q. Smith', 'Robert Jones']. One entry per author. Omit for an anonymous/no-author work.","title":"Authors"},"year":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Publication year, e.g. 2021. Omit for 'n.d.' (no date).","title":"Year"},"container_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Journal name (journal_article), site name (website), or proceedings/conference name (conference_paper). Not used for book/report.","title":"Container Title"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Publisher name (book/report), or the hosting organization for a website if different from the site name.","title":"Publisher"},"volume":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal volume number.","title":"Volume"},"issue":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal issue number.","title":"Issue"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Page range, e.g. '414-456'.","title":"Pages"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full URL, including scheme.","title":"Url"},"access_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date you accessed a website, as YYYY-MM-DD (MLA/Chicago recommend this for web sources).","title":"Access Date"},"edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Edition, e.g. '2nd' (book/report only).","title":"Edition"}},"required":["source_type","title"],"title":"format_mlaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/format_chicago":{"post":{"operationId":"format_chicago","summary":"Compute a Chicago Manual of Style (17th ed., author-date) reference-list entry. Convenience wrapper over","description":"Compute a Chicago Manual of Style (17th ed., author-date) reference-list entry. Convenience wrapper over\n    format_citation(style=\"chicago\").","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"source_type":{"description":"book | journal_article | website | report | conference_paper","title":"Source Type","type":"string"},"title":{"description":"The work's own title (not the journal/site name).","minLength":1,"title":"Title","type":"string"},"authors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Full names in natural order, e.g. ['Jane Q. Smith', 'Robert Jones']. One entry per author. Omit for an anonymous/no-author work.","title":"Authors"},"year":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Publication year, e.g. 2021. Omit for 'n.d.' (no date).","title":"Year"},"container_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Journal name (journal_article), site name (website), or proceedings/conference name (conference_paper). Not used for book/report.","title":"Container Title"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Publisher name (book/report), or the hosting organization for a website if different from the site name.","title":"Publisher"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Place of publication, e.g. 'New York' or 'Belmont, CA' (used by Chicago and IEEE for books).","title":"City"},"volume":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal volume number.","title":"Volume"},"issue":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal issue number.","title":"Issue"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Page range, e.g. '414-456'.","title":"Pages"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full URL, including scheme.","title":"Url"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A bare DOI (e.g. '10.7560/IC47402') or a full doi.org URL; used instead of url when both a doi and url exist for a journal article.","title":"Doi"},"pub_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full publication date as YYYY-MM-DD or YYYY-MM, for a website or dated post (more precise than year alone).","title":"Pub Date"},"access_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date you accessed a website, as YYYY-MM-DD (MLA/Chicago recommend this for web sources).","title":"Access Date"},"edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Edition, e.g. '2nd' (book/report only).","title":"Edition"},"season":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Issue season, e.g. 'Winter' (Chicago journal articles only).","title":"Season"}},"required":["source_type","title"],"title":"format_chicagoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/format_ieee":{"post":{"operationId":"format_ieee","summary":"Compute an IEEE reference-list entry (unnumbered; add your own [n] when you place it in the list).","description":"Compute an IEEE reference-list entry (unnumbered; add your own [n] when you place it in the list).\n    Convenience wrapper over format_citation(style=\"ieee\").","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"source_type":{"description":"book | journal_article | website | report | conference_paper","title":"Source Type","type":"string"},"title":{"description":"The work's own title (not the journal/site name).","minLength":1,"title":"Title","type":"string"},"authors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Full names in natural order, e.g. ['Jane Q. Smith', 'Robert Jones']. One entry per author. Omit for an anonymous/no-author work.","title":"Authors"},"year":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Publication year, e.g. 2021. Omit for 'n.d.' (no date).","title":"Year"},"container_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Journal name (journal_article), site name (website), or proceedings/conference name (conference_paper). Not used for book/report.","title":"Container Title"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Publisher name (book/report), or the hosting organization for a website if different from the site name.","title":"Publisher"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Place of publication, e.g. 'New York' or 'Belmont, CA' (used by Chicago and IEEE for books).","title":"City"},"volume":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal volume number.","title":"Volume"},"issue":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal issue number.","title":"Issue"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Page range, e.g. '414-456'.","title":"Pages"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full URL, including scheme.","title":"Url"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A bare DOI (e.g. '10.7560/IC47402') or a full doi.org URL; used instead of url when both a doi and url exist for a journal article.","title":"Doi"},"pub_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full publication date as YYYY-MM-DD or YYYY-MM, for a website or dated post (more precise than year alone).","title":"Pub Date"},"access_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date you accessed a website, as YYYY-MM-DD (MLA/Chicago recommend this for web sources).","title":"Access Date"},"edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Edition, e.g. '2nd' (book/report only).","title":"Edition"}},"required":["source_type","title"],"title":"format_ieeeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_all_styles":{"post":{"operationId":"compare_all_styles","summary":"Compute the same source's citation in all four styles (APA, MLA, Chicago, IEEE) at once, for comparison.","description":"Compute the same source's citation in all four styles (APA, MLA, Chicago, IEEE) at once, for comparison.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"source_type":{"description":"book | journal_article | website | report | conference_paper","title":"Source Type","type":"string"},"title":{"description":"The work's own title (not the journal/site name).","minLength":1,"title":"Title","type":"string"},"authors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Full names in natural order, e.g. ['Jane Q. Smith', 'Robert Jones']. One entry per author. Omit for an anonymous/no-author work.","title":"Authors"},"year":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Publication year, e.g. 2021. Omit for 'n.d.' (no date).","title":"Year"},"container_title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Journal name (journal_article), site name (website), or proceedings/conference name (conference_paper). Not used for book/report.","title":"Container Title"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Publisher name (book/report), or the hosting organization for a website if different from the site name.","title":"Publisher"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Place of publication, e.g. 'New York' or 'Belmont, CA' (used by Chicago and IEEE for books).","title":"City"},"volume":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal volume number.","title":"Volume"},"issue":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Journal issue number.","title":"Issue"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Page range, e.g. '414-456'.","title":"Pages"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full URL, including scheme.","title":"Url"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A bare DOI (e.g. '10.7560/IC47402') or a full doi.org URL; used instead of url when both a doi and url exist for a journal article.","title":"Doi"},"pub_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Full publication date as YYYY-MM-DD or YYYY-MM, for a website or dated post (more precise than year alone).","title":"Pub Date"},"access_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date you accessed a website, as YYYY-MM-DD (MLA/Chicago recommend this for web sources).","title":"Access Date"},"edition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Edition, e.g. '2nd' (book/report only).","title":"Edition"}},"required":["source_type","title"],"title":"compare_all_stylesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/in_text_citation":{"post":{"operationId":"in_text_citation","summary":"Format the parenthetical/bracketed in-text citation used in running text (not the reference-list entry).","description":"Format the parenthetical/bracketed in-text citation used in running text (not the reference-list entry).\n    Use for \"what's the in-text citation for this source\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"style":{"description":"apa | mla | chicago | ieee","title":"Style","type":"string"},"authors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Full author names. Leave empty (or omit) only for IEEE (numbered, not author-based).","title":"Authors"},"year":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"null"}],"default":null,"description":"Publication year, e.g. 2021. Omit for 'n.d.' (no date).","title":"Year"},"page":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Page number/range being cited, if any.","title":"Page"},"ref_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"IEEE only: this source's position in your numbered reference list.","title":"Ref Number"}},"required":["style"],"title":"in_text_citationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/validate_citation_fields":{"post":{"operationId":"validate_citation_fields","summary":"Check which fields are required or recommended for a source_type before formatting, and what's missing.","description":"Check which fields are required or recommended for a source_type before formatting, and what's missing.\n    Use for \"what do I need for an IEEE conference paper citation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"source_type":{"description":"book | journal_article | website | report | conference_paper","title":"Source Type","type":"string"},"fields":{"additionalProperties":true,"description":"The fields you have so far, e.g. {'authors': [...], 'title': '...', 'year': 2020}.","title":"Fields","type":"object"}},"required":["source_type","fields"],"title":"validate_citation_fieldsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_supported_source_types":{"post":{"operationId":"list_supported_source_types","summary":"List the source types this connector formats (book, journal_article, website, report, conference_paper)","description":"List the source types this connector formats (book, journal_article, website, report, conference_paper)\n    and what each needs.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_supported_source_typesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_styles":{"post":{"operationId":"list_styles","summary":"List the four supported citation styles with a short note on each style's key conventions here.","description":"List the four supported citation styles with a short note on each style's key conventions here.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_stylesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}