Accord Developers

Welcome to the developer documentation for the Accord platform. The Accord API is a single GraphQL endpoint that exposes everything you need to read and update Accord data programmatically: Accords, stakeholders, activity, Playbooks, and more.

What you'll find here

• Authentication: get an API key and authenticate requests.
• Quickstarts
  • Loading a Workspace Account: compose WorkspaceAccount, Account, and Profile.
  • Loading an Accord: hydrate an Accord with stages, steps, members, resources, and summaries.
• Filtering & conditions: query, paginate, order, and filter results.
• Activity export: poll every activity event in your workspace.
• Errors: error response shape and how to handle them.
• API reference: auto-generated reference for every query, mutation, type, input, and enum.
• Changelog: notable changes to the API.

Quick start

curl -X POST https://api.inaccord.com/graphql \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"{ currentUser { id displayName } }"}'

If you have an API key from your Accord workspace, that command returns a JSON response with your current user. If you don't have a key yet, see Authentication for how to create one.

Where the API lives

The production GraphQL endpoint is https://api.inaccord.com/graphql.

Moving off api2.inaccord.com

https://api2.inaccord.com/graphql served the API historically and still answers today, but it will stop accepting HTTP requests. Point your integration at https://api.inaccord.com/graphql. The request, the Authorization header, and the response are identical; only the hostname changes. The retirement date will be announced on the changelog ahead of time.