POSTpartial

Explicitly approve bounded standing or existing-case authority

A signed-in verified principal explicitly accepts current terms. Name a case already owned by that principal or bounded standing authority. Acts, USD cap, expiry, ordinary clock, standard procedure and optional transaction scope are checked server-side. Standing authority lapses when Rules or disclosure changes.

/api/authorizations/authority-grantscreateAccountAuthorityGrant

Authentication and authority

Use one listed account-session, scoped OAuth, or partner credential alternative. Account tokens retain the approving account’s authority. Cookie-authenticated writes require same-origin authorization. Alternatives are OR; schemes in one alternative are AND.

CanonicalSession

Parameters

This operation has no path, query, or header parameters.

Request body

Required request body.

application/json

{
  "type": "object",
  "properties": {
    "clientId": {
      "type": "string"
    },
    "scope": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "cases:read",
          "filings:write",
          "answers:write",
          "submissions:write",
          "records:confirm",
          "records:write",
          "invitations:write",
          "messages:write",
          "remedies:write",
          "consents:write",
          "offline_access",
          "representatives:manage",
          "procedural:request",
          "termination:write"
        ]
      }
    },
    "caseId": {
      "type": "string"
    },
    "standing": {
      "$ref": "#/components/schemas/AccountStandingBounds",
      "type": "object",
      "properties": {
        "acts": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "file_dispute",
              "answer"
            ]
          }
        },
        "maximumAmount": {
          "type": "object",
          "properties": {
            "currency": {
              "type": "string",
              "const": "USD"
            },
            "minorUnits": {
              "type": "string",
              "pattern": "^[1-9][0-9]{0,14}$"
            }
          },
          "required": [
            "currency",
            "minorUnits"
          ]
        },
        "transactionIds": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "procedure": {
          "type": "string",
          "const": "standard"
        },
        "clock": {
          "type": "string",
          "const": "ordinary"
        }
      },
      "required": [
        "acts",
        "maximumAmount",
        "expiresAt",
        "procedure",
        "clock"
      ]
    },
    "accepted": {
      "type": "boolean",
      "const": true
    },
    "terms": {
      "$ref": "#/components/schemas/AccountOAuthTerms",
      "type": "object",
      "properties": {
        "rulesVersion": {
          "type": "string"
        },
        "rulesHash": {
          "type": "string"
        },
        "disclosureVersion": {
          "type": "string"
        },
        "disclosureHash": {
          "type": "string"
        }
      },
      "required": [
        "rulesVersion",
        "rulesHash",
        "disclosureVersion",
        "disclosureHash"
      ]
    }
  },
  "required": [
    "clientId",
    "scope",
    "accepted",
    "terms"
  ]
}

Responses

201

Successful operation.

application/json

{
  "type": "object",
  "properties": {
    "grant": {
      "$ref": "#/components/schemas/AccountAuthorityGrant",
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "principalId": {
          "type": "string"
        },
        "clientId": {
          "type": "string"
        },
        "delegatePartnerId": {
          "type": "string"
        },
        "scope": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "cases:read",
              "filings:write",
              "answers:write",
              "submissions:write",
              "records:confirm",
              "records:write",
              "invitations:write",
              "messages:write",
              "remedies:write",
              "consents:write",
              "offline_access",
              "representatives:manage",
              "procedural:request",
              "termination:write"
            ]
          }
        },
        "resource": {
          "type": "string"
        },
        "terms": {
          "$ref": "#/components/schemas/AccountOAuthTerms",
          "type": "object",
          "properties": {
            "rulesVersion": {
              "type": "string"
            },
            "rulesHash": {
              "type": "string"
            },
            "disclosureVersion": {
              "type": "string"
            },
            "disclosureHash": {
              "type": "string"
            }
          },
          "required": [
            "rulesVersion",
            "rulesHash",
            "disclosureVersion",
            "disclosureHash"
          ]
        },
        "caseId": {
          "type": "string"
        },
        "caseBinding": {
          "type": "object",
          "properties": {
            "disputeId": {
              "type": "string"
            },
            "membershipId": {
              "type": "string"
            },
            "side": {
              "type": "string",
              "enum": [
                "claimant",
                "respondent"
              ]
            }
          },
          "required": [
            "disputeId",
            "membershipId",
            "side"
          ]
        },
        "standing": {
          "$ref": "#/components/schemas/AccountStandingBounds",
          "type": "object",
          "properties": {
            "acts": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "file_dispute",
                  "answer"
                ]
              }
            },
            "maximumAmount": {
              "type": "object",
              "properties": {
                "currency": {
                  "type": "string",
                  "const": "USD"
                },
                "minorUnits": {
                  "type": "string",
                  "pattern": "^[1-9][0-9]{0,14}$"
                }
              },
              "required": [
                "currency",
                "minorUnits"
              ]
            },
            "transactionIds": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "expiresAt": {
              "type": "string",
              "format": "date-time"
            },
            "procedure": {
              "type": "string",
              "const": "standard"
            },
            "clock": {
              "type": "string",
              "const": "ordinary"
            }
          },
          "required": [
            "acts",
            "maximumAmount",
            "expiresAt",
            "procedure",
            "clock"
          ]
        },
        "approvedAt": {
          "type": "string"
        },
        "expiresAt": {
          "type": "string"
        },
        "revokedAt": {
          "type": "string"
        },
        "source": {
          "type": "string",
          "enum": [
            "authorization_code",
            "hosted_link",
            "agent_registration"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "active",
            "expired",
            "revoked",
            "reacceptance_required"
          ]
        }
      },
      "required": [
        "id",
        "principalId",
        "clientId",
        "scope",
        "resource",
        "terms",
        "approvedAt",
        "expiresAt",
        "source"
      ]
    }
  },
  "required": [
    "grant"
  ]
}
default

Authorization failure; consent_required requires explicit reacceptance.

application/json

{
  "$ref": "#/components/schemas/AccountOAuthError",
  "type": "object",
  "properties": {
    "error": {
      "type": "string"
    },
    "error_description": {
      "type": "string"
    }
  },
  "required": [
    "error"
  ]
}

Example response

Successful response

{
  "grant": {
    "id": "id_test",
    "principalId": "principal_test_123",
    "clientId": "clientId_test",
    "scope": [
      "cases:read"
    ],
    "resource": "resource_test",
    "terms": {
      "rulesVersion": "rulesVersion_test",
      "rulesHash": "rulesHash_test",
      "disclosureVersion": "disclosureVersion_test",
      "disclosureHash": "disclosureHash_test"
    },
    "approvedAt": "approvedAt_test",
    "expiresAt": "expiresAt_test",
    "source": "authorization_code"
  }
}

Errors

Read the response status and stable error code. See errors and rate limits for recovery. Refresh the resource before resolving a state or digest conflict.

Idempotency and retries

  • For throttling, honor Retry-After when present. Back off on retryable server failures.
  • The request is accepted only when its credential, authority, case state, and resource preconditions are satisfied.