• Documentation
  • API Reference
Information
Reviews
    Retrieve a reviewgetRetrieve all reviewsgetCreate a reviewpostList redline evaluations for a reviewgetRetrieve a single redline evaluationgetUpdate a redline evaluationpatchList flag violations for a reviewgetRetrieve a single flag violationgetUpdate a flag violationpatchDownload review bundle (ZIP)getDownload review audit documentgetDownload processed (redlined) contractgetDownload original uploaded contractget
Imported Files
    List imported filesget
Playbooks
    Retrieve all playbooksgetCreate a playbookpostRetrieve a playbookgetArchive a playbookdeleteUpdate a playbookpatch
Playbook Rules
    List playbook rulesgetCreate a playbook rulepostRetrieve a playbook rulegetDelete a playbook ruledeleteUpdate a playbook rulepatch
Invitations
    List invitationsgetCreate an invitationpostRetrieve an invitationget
Organization
    List organizationsgetRetrieve organizationgetUpdate organizationpatch
MCP
    MCP Serverpost
Schemas
powered by Zuplo
Gerri API
Gerri API

Organization

Endpoints for retrieving and updating the current organization (name and default reviewer).

List organizations

GET
https://api.gerri.commonpaper.com
/v1/organizations

Lists all organizations the authenticated user belongs to, ordered by created_at descending (newest first). Use an organization id from this list as organization_id on nested routes.

List organizations › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List organizations › Responses

A list of organizations for the authenticated user

OrganizationsListResponse
​OrganizationResource[] · required
GET/v1/organizations
curl https://api.gerri.commonpaper.com/v1/organizations \ --header 'Authorization: Bearer <token>'
Example Responses
{ "data": [ { "id": "79d7ae9b-9499-4c36-af51-8a87e13ab74e", "type": "organization", "attributes": { "name": "Example Corp", "ingestion_email_address": "examplecorp-434@i.gerri.commonpaper.com", "default_reviewer_id": "b1a2c3d4-e5f6-7890-abcd-ef1234567890", "default_reviewer_email": "admin@example.com", "created_at": "2026-04-01T12:00:00.000Z", "updated_at": "2026-05-10T14:22:01.000Z" } } ] }
json
application/json

Retrieve organization

GET
https://api.gerri.commonpaper.com
/v1/organizations/{organization_id}

Returns the organization specified in the path. Includes name, ingestion_email_address (read-only), default_reviewer_id, default_reviewer_email, and timestamps.

Retrieve organization › path Parameters

organization_id
​string · uuid · required

Organization id

Retrieve organization › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Retrieve organization › Responses

The current organization

OrganizationResponse
​OrganizationResource · required
GET/v1/organizations/{organization_id}
curl https://api.gerri.commonpaper.com/v1/organizations/:organization_id \ --header 'Authorization: Bearer <token>'
Example Responses
{ "data": { "id": "79d7ae9b-9499-4c36-af51-8a87e13ab74e", "type": "organization", "attributes": { "name": "Example Corp", "ingestion_email_address": "examplecorp-434@i.gerri.commonpaper.com", "default_reviewer_id": "b1a2c3d4-e5f6-7890-abcd-ef1234567890", "default_reviewer_email": "admin@example.com", "created_at": "2026-04-01T12:00:00.000Z", "updated_at": "2026-05-10T14:22:01.000Z" } } }
json
application/json

Update organization

PATCH
https://api.gerri.commonpaper.com
/v1/organizations/{organization_id}

Updates the organization specified in the path. Send any of name or default_reviewer_id. default_reviewer_id must refer to an available reviewer for the organization.

Update organization › path Parameters

organization_id
​string · uuid · required

Organization id

Update organization › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Update organization › Request Body

PatchOrganizationBody
name
​string · minLength: 1

New name for the organization. Omit this field to leave the name unchanged; if sent, the value must be a non-empty string.

default_reviewer_id
​string · uuid · minLength: 1 · pattern: ^[0-9a-fA-F]{8}-[0-9…

User id of the new default reviewer; must be an available reviewer for the organization. Omit this field to leave the reviewer unchanged; if sent, the value must be a canonical UUID string (8-4-4-4-12 hex digits).

Update organization › Responses

Updated organization

OrganizationResponse
​OrganizationResource · required
PATCH/v1/organizations/{organization_id}
curl https://api.gerri.commonpaper.com/v1/organizations/:organization_id \ --request PATCH \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "name": "Example Corp LLC" }'
Example Request Body
{ "name": "Example Corp LLC" }
json
application/json
Example Responses
{ "data": { "id": "79d7ae9b-9499-4c36-af51-8a87e13ab74e", "type": "organization", "attributes": { "name": "Example Corp LLC", "ingestion_email_address": "examplecorp-434@i.gerri.commonpaper.com", "default_reviewer_id": "c2d3e4f5-a6b7-8901-bcde-f12345678901", "default_reviewer_email": "reviewer@example.com", "created_at": "2026-04-01T12:00:00.000Z", "updated_at": "2026-05-10T16:00:00.000Z" } } }
json
application/json
InvitationsMCP