Skip to content
OpenBot

platform.updatePlatformOrganizationCredits

PATCH
/v1/platform/organizations/{organizationId}/credits
curl --request PATCH \
  --url https://example.com/v1/platform/organizations/example/credits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "enabled": true }'

Turns the credits of an organization on or off. While they are on, the organization can use the models of the platform only when its balance is more than 0.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
organizationId
required
string

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
enabled
required
boolean

Example generated

{
  "enabled": true
}

Responses

Section titled “Responses”

200

Section titled “200”

Success

Media typeapplication/json
object
enabled
required
boolean
balanceMicros
required
integer
>= -9007199254740991 <= 9007199254740991
grants
required
Array<object>
object
id
required
string
amountMicros
required
integer
>= -9007199254740991 <= 9007199254740991
note
required
string
createdBy
required
string
createdAt
required
string

Example generated

{
  "enabled": true,
  "balanceMicros": 1,
  "grants": [
    {
      "id": "example",
      "amountMicros": 1,
      "note": "example",
      "createdBy": "example",
      "createdAt": "example"
    }
  ]
}

401

Section titled “401”

AuthenticationRequired

Media typeapplication/json
object
_tag
required
string
Allowed values: AuthenticationRequired

Example 

{
  "_tag": "AuthenticationRequired"
}

403

Section titled “403”

PermissionDenied | MembershipRequired | ForbiddenOrigin

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: PermissionDenied
permission
required
string
Allowed values: responses.run sessions.read sessions.write requests.resolve agents.read agents.write agents.delegate triggers.read triggers.write channels.read channels.write channels.use channel_identities.read channel_identities.write connections.read connections.write apps.use apps.publish models.use tokens.read tokens.write organization.read organization.write roles.write model_providers.read model_providers.write sso.read sso.write platform.read platform.write members.read members.write audit_logs.read usage.read budgets.read budgets.write
resource
required
string

Example 

{
  "_tag": "PermissionDenied",
  "permission": "responses.run"
}

404

Section titled “404”

OrganizationNotFound

Media typeapplication/json
object
_tag
required
string
Allowed values: OrganizationNotFound
organizationId
required
string

Example 

{
  "_tag": "OrganizationNotFound"
}

503

Section titled “503”

PlatformUnavailable | OrganizationStorageUnavailable | AuthorizationUnavailable | AuthenticationUnavailable

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: PlatformUnavailable

Example 

{
  "_tag": "PlatformUnavailable"
}