Partner terms tools

• partner_terms_accept: Accept the partner terms
• partner_terms_get: Get the partner terms acceptance

partner_terms_accept#

Accept the partner terms. Operation partner_terms.accept · Organization level · permission org:write · risk tier write · since M13

Records that the organization accepts a version of Ownrecord's Partner and App Terms (/legal/partners), which apply to apps the organization lists for every organization. Read the version first at /legal/partners/{version}. version must be the version in effect or an announced newer one (see acceptableVersions in partner_terms.get). A material change of the terms asks for acceptance again before the next listing application.

Only a person signed in to the console can accept, with org:write (owners and admins). API keys, agents, apps and OAuth clients can't, and neither can platform staff under a support-access grant. Accepting the version already accepted changes nothing.

Annotations: readOnlyHint: false · destructiveHint: false · idempotentHint: true · openWorldHint: false

Arguments#

• Idempotency: the result returns the idempotency_key used, yours or one the server generated. Retry with it: a call with the same key and arguments never acts twice (keys are kept for 24 hours).
• Dry run: supported. dry_run: true checks permissions and rules and computes the result, then rolls everything back.

Errors#

• legal_version_not_acceptable: The version isn't the one in effect or an announced newer one.
• permission_denied: You aren't an owner or admin signed in to the console.
• validation_failed: The version is missing.
• version_conflict: The acceptance changed at the same time; retry.

Example#

Accept version 1.0

Arguments:

{
  "version": "1.0",
  "idempotency_key": "8d0c5f8e-4b7a-4e43-9b0f-2f6a0c1d9e21"
}

Result output:

{
  "object": "partner_terms_acceptance",
  "organizationId": "org_01m4ttwd3veh9apbewxheq5xhb",
  "status": "accepted",
  "actionRequired": false,
  "acceptedVersion": "1.0",
  "acceptedAt": "2026-10-30T08:55:00.000Z",
  "acceptedBy": "usr_01m4ttwd3veh9apbewxheq5xhf",
  "current": {
    "version": "1.0",
    "effectiveDate": "2026-10-26",
    "status": "draft",
    "url": "/legal/partners",
    "versionUrl": "/legal/partners/1.0"
  },
  "upcoming": null,
  "acceptableVersions": ["1.0"]
}

partner_terms_get#

Get the partner terms acceptance. Operation partner_terms.get · Organization level · permission org:read · risk tier read · since M13

Returns which version of Ownrecord's Partner and App Terms (/legal/partners) the organization accepted, the version in effect, and any announced change. Listing an app (apps.listing.submit) needs the terms accepted: status is accepted, update_announced (a material change takes effect on upcoming.effectiveDate; accept it ahead of time), acceptance_required (a new version is in effect: accept it before the next application) or not_accepted. actionRequired is true when an application would be refused now.

Readable by every member of the organization.

Annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false

Arguments#

This tool takes no arguments.

• Read-only: changes nothing; idempotency_key is ignored.

Errors#

• permission_denied: You can't read this organization.

Examples#

Accepted

Arguments:

{}

Result output:

{
  "object": "partner_terms_acceptance",
  "organizationId": "org_01m4ttwd3veh9apbewxheq5xhb",
  "status": "accepted",
  "actionRequired": false,
  "acceptedVersion": "1.0",
  "acceptedAt": "2026-10-30T08:55:00.000Z",
  "acceptedBy": "usr_01m4ttwd3veh9apbewxheq5xhf",
  "current": {
    "version": "1.0",
    "effectiveDate": "2026-10-26",
    "status": "draft",
    "url": "/legal/partners",
    "versionUrl": "/legal/partners/1.0"
  },
  "upcoming": null,
  "acceptableVersions": ["1.0"]
}

Not accepted yet

Arguments:

{}

Result output:

{
  "object": "partner_terms_acceptance",
  "organizationId": "org_01m4ttwd3veh9apbewxheq5xhb",
  "status": "not_accepted",
  "actionRequired": true,
  "acceptedVersion": null,
  "acceptedAt": null,
  "acceptedBy": null,
  "current": {
    "version": "1.0",
    "effectiveDate": "2026-10-26",
    "status": "draft",
    "url": "/legal/partners",
    "versionUrl": "/legal/partners/1.0"
  },
  "upcoming": null,
  "acceptableVersions": ["1.0"]
}