Sign in

v1

latestOpenAPI 3.0.0UNLICENSED2026-07-26178479713.7 KB
grants

aid_auths_client_grants_post

scopes:

  • admin:accounts
  • write:accounts
post/accounts/{oid}/auth/client-grants

Path parameters

oidstring ^[PT]{1}(?=(?:.{3}|.{8})$)[0-9]*$ required

An id that uniquely identifies the account or owner (partner)

Request body

idstring uuid

An UUID that uniquely identifies the resource

created_atstring date-time

The date-time when the resource was created

created_bystring

The ID of the user/client created the resource

updated_atstring date-time

The date-time when the resource was last updated

deleted_bystring

The ID of the user/client created the resource

deleted_atstring date-time
client_idstring required
audiencestring required
scopestring[] required
type'any' | 'authorization_code' | 'client_credentials' | 'password'

Limit the usage of the grant. A grant with grant_types set to only authorization_code cannot be used in Get Token when calling the endpoint with grant_type=client_credentials

Example request

{
  "created_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "deleted_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "audience": "https://api.dintero.com/v1/accounts/P00000000",
  "scope": [
    "receipts:write"
  ],
  "oidc": {
    "authority": "https://identityserver.example.com/access"
  }
}

Response

Grant created

idstring uuid

An UUID that uniquely identifies the resource

created_atstring date-time

The date-time when the resource was created

created_bystring

The ID of the user/client created the resource

updated_atstring date-time

The date-time when the resource was last updated

deleted_bystring

The ID of the user/client created the resource

deleted_atstring date-time
client_idstring required
audiencestring required
scopestring[] required
type'any' | 'authorization_code' | 'client_credentials' | 'password'

Limit the usage of the grant. A grant with grant_types set to only authorization_code cannot be used in Get Token when calling the endpoint with grant_type=client_credentials

Example response

{
  "created_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "deleted_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "audience": "https://api.dintero.com/v1/accounts/P00000000",
  "scope": [
    "receipts:write"
  ],
  "oidc": {
    "authority": "https://identityserver.example.com/access"
  }
}