{"openapi":"3.1.0","info":{"title":"Concord (BYOK) API","version":"0.1.0","description":"Concord (BYOK) lets an AI assistant read your own Concord data through the Concord API with a key you supply (Concord API key). Read-only: 12 tools (get_me, list_my_organizations, get_organization, list_members, list_folders, list_folder_agreements, get_agreement, get_agreement_summary, list_agreement_versions, list_tags, list_reports, list_organization_events). The BYOK key travels with each...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-concord.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-concord/docs"},"termsOfService":"https://connectorbay.com/byok-concord/terms"},"servers":[{"url":"https://byok-concord.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-concord/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_me":{"post":{"operationId":"get_me","summary":"Show the Concord user the API key belongs to: id, name, email, time zone and current organization id. Use for \"Which Con","description":"Show the Concord user the API key belongs to: id, name, email, time zone and current organization id. Use for \"Which Concord account is my API key connected to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_meArguments","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_my_organizations":{"post":{"operationId":"list_my_organizations","summary":"List the Concord organizations the user belongs to, with the user's role in each. Use for \"Which Concord organizations a","description":"List the Concord organizations the user belongs to, with the user's role in each. Use for \"Which Concord organizations am I part of\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_my_organizationsArguments","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/get_organization":{"post":{"operationId":"get_organization","summary":"Get one Concord organization: name, plan, region, subsidiaries and whether AI features are on. Use for \"What plan and re","description":"Get one Concord organization: name, plan, region, subsidiaries and whether AI features are on. Use for \"What plan and region is Concord organization 1234 on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id (from list_my_organizations).","title":"Organization Id","type":"integer"}},"required":["organization_id"],"title":"get_organizationArguments","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_members":{"post":{"operationId":"list_members","summary":"List members of a Concord organization with role, groups and active flag; paged by start and limit. Use for \"Who are the","description":"List members of a Concord organization with role, groups and active flag; paged by start and limit. Use for \"Who are the members of Concord organization 1234\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id (from list_my_organizations).","title":"Organization Id","type":"integer"},"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter on email or full name.","title":"Search"},"start":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset of the first member to return.","title":"Start"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many members to return.","title":"Limit"}},"required":["organization_id"],"title":"list_membersArguments","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_folders":{"post":{"operationId":"list_folders","summary":"Get the folder tree of a Concord organization with document counts and sub-folders. Use for \"Show the folder structure o","description":"Get the folder tree of a Concord organization with document counts and sub-folders. Use for \"Show the folder structure of Concord organization 1234\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id (from list_my_organizations).","title":"Organization Id","type":"integer"}},"required":["organization_id"],"title":"list_foldersArguments","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_folder_agreements":{"post":{"operationId":"list_folder_agreements","summary":"List agreements in one Concord folder with status, dates, signature counts and tags; paged and searchable. Use for \"Whic","description":"List agreements in one Concord folder with status, dates, signature counts and tags; paged and searchable. Use for \"Which contracts are in Concord folder 2\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id (from list_my_organizations).","title":"Organization Id","type":"integer"},"folder_id":{"description":"Numeric folder id (from list_folders).","title":"Folder Id","type":"integer"},"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter on agreement name, description and parties.","title":"Search"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"items_per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Agreements per page.","title":"Items Per Page"}},"required":["organization_id","folder_id"],"title":"list_folder_agreementsArguments","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/get_agreement":{"post":{"operationId":"get_agreement","summary":"Get one Concord agreement: title, status, folder, tags, permission, creator and creation date. Use for \"Show details of ","description":"Get one Concord agreement: title, status, folder, tags, permission, creator and creation date. Use for \"Show details of Concord agreement b6d1a2f0-1111-4222-8333-444455556666\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id (from list_my_organizations).","title":"Organization Id","type":"integer"},"agreement_uid":{"description":"Agreement UID (from list_folder_agreements).","maxLength":200,"title":"Agreement Uid","type":"string"}},"required":["organization_id","agreement_uid"],"title":"get_agreementArguments","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/get_agreement_summary":{"post":{"operationId":"get_agreement_summary","summary":"Get the lifecycle summary of a Concord agreement: description, signature date, end date, renewal and termination data. U","description":"Get the lifecycle summary of a Concord agreement: description, signature date, end date, renewal and termination data. Use for \"When does Concord agreement b6d1a2f0-1111-4222-8333-444455556666 end and renew\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id (from list_my_organizations).","title":"Organization Id","type":"integer"},"agreement_uid":{"description":"Agreement UID (from list_folder_agreements).","maxLength":200,"title":"Agreement Uid","type":"string"}},"required":["organization_id","agreement_uid"],"title":"get_agreement_summaryArguments","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_agreement_versions":{"post":{"operationId":"list_agreement_versions","summary":"List the versions of a Concord agreement with date, type and author. Use for \"How many versions does Concord agreement b","description":"List the versions of a Concord agreement with date, type and author. Use for \"How many versions does Concord agreement b6d1a2f0-1111-4222-8333-444455556666 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id (from list_my_organizations).","title":"Organization Id","type":"integer"},"agreement_uid":{"description":"Agreement UID (from list_folder_agreements).","maxLength":200,"title":"Agreement Uid","type":"string"}},"required":["organization_id","agreement_uid"],"title":"list_agreement_versionsArguments","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_tags":{"post":{"operationId":"list_tags","summary":"List the tags of a Concord organization, optionally with usage counts per document type. Use for \"What tags does Concord","description":"List the tags of a Concord organization, optionally with usage counts per document type. Use for \"What tags does Concord organization 1234 use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id.","maximum":999999999,"minimum":1,"title":"Organization Id","type":"integer"},"access_data":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include how many contracts use each tag.","title":"Access Data"}},"required":["organization_id"],"title":"list_tagsArguments","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_reports":{"post":{"operationId":"list_reports","summary":"List saved agreement reports of a Concord organization with their filters and update time. Use for \"Which saved reports ","description":"List saved agreement reports of a Concord organization with their filters and update time. Use for \"Which saved reports exist in Concord organization 1234\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id (from list_my_organizations).","title":"Organization Id","type":"integer"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"items_per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Reports per page.","title":"Items Per Page"}},"required":["organization_id"],"title":"list_reportsArguments","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_organization_events":{"post":{"operationId":"list_organization_events","summary":"List organization events (agreements created, signed, viewed, users added) in a date range of at most the documented win","description":"List organization events (agreements created, signed, viewed, users added) in a date range of at most the documented window. Use for \"What happened in Concord organization 1234 last week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Numeric Concord organization id (from list_my_organizations).","title":"Organization Id","type":"integer"},"start":{"description":"Start date, yyyy-MM-dd.","maxLength":10,"title":"Start","type":"string"},"end":{"description":"End date, yyyy-MM-dd; the range between start and end is limited by the API.","maxLength":10,"title":"End","type":"string"}},"required":["organization_id","start","end"],"title":"list_organization_eventsArguments","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}}}}