Org

Issue a project grant, optionally with its first grant key (owner-only)

Owner-only on the project's owning org. Issues a capability grant (e.g. deploy, functions:write) to a wallet's principal: the permission row for an agent or CI principal that is not an org member. With key, also mints the grant's first grant key in the same transaction (a credential narrower than the grant, for an agent without a wallet of its own); the key's token is returned ONCE and minting it takes the grant_key.issue step-up for a sign-in session. Audited.

post/projects/v1/{project_id}/grants

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/projects/v1/{project_id}/grants
  • Auth: API key in header SIGN-IN-WITH-X

Path parameters

project_idstring required

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Request body

walletstring required
capabilitystring required
policyobject
expires_atstring date-time nullable

Example request

{
  "capability": "functions:write"
}

Response

Grant issued

statusstring
grant_idstring uuid
principal_idstring uuid

Changes

No recorded changes to this operation across all 1 revision of this API.