> ## Documentation Index > Fetch the complete documentation index at: https://conductorone-eu-instance.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Update > Update the period or the default limit. currency_code is immutable after Create and update_mask rejects it: an amount denominated in a currency the policy no longer names faults the acquire path rather than denying it. ## OpenAPI ````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/funds/policy/update openapi: 3.1.0 info: description: The C1 API is a HTTP API for managing C1 resources. title: C1 API version: 0.1.0-alpha servers: - description: The C1 API server for the current tenant. url: https://{tenantDomain}.conductor.one variables: tenantDomain: default: example description: The domain of the tenant to use for this request. security: - bearerAuth: [] oauth: [] paths: /api/v1/funds/policy/update: post: tags: - Fund Policy summary: Update description: |- Update the period or the default limit. currency_code is immutable after Create and update_mask rejects it: an amount denominated in a currency the policy no longer names faults the acquire path rather than denying it. operationId: c1.api.funds.v1.FundPolicyService.Update requestBody: content: application/json: schema: $ref: >- #/components/schemas/c1.api.funds.v1.FundPolicyServiceUpdateRequest responses: '200': content: application/json: schema: $ref: >- #/components/schemas/c1.api.funds.v1.FundPolicyServiceUpdateResponse description: Successful response components: schemas: c1.api.funds.v1.FundPolicyServiceUpdateRequest: description: The FundPolicyServiceUpdateRequest message. properties: policy: oneOf: - $ref: '#/components/schemas/c1.api.funds.v1.FundPolicy' - type: 'null' updateMask: type: - string - 'null' title: Fund Policy Service Update Request type: object x-speakeasy-name-override: FundPolicyServiceUpdateRequest c1.api.funds.v1.FundPolicyServiceUpdateResponse: description: The FundPolicyServiceUpdateResponse message. properties: policy: oneOf: - $ref: '#/components/schemas/c1.api.funds.v1.FundPolicy' - type: 'null' title: Fund Policy Service Update Response type: object x-speakeasy-name-override: FundPolicyServiceUpdateResponse c1.api.funds.v1.FundPolicy: description: >- FundPolicy is the tenant's fund policy as the API renders it. Every field is server-owned on the way out; requests name the fields they change rather than sending this message back. properties: createdAt: format: date-time type: - string - 'null' currencyCode: description: ISO 4217. Set at Create and immutable thereafter. type: string defaultLimit: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.SpendLimit' - type: 'null' orgCeiling: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.SpendControls' - type: 'null' period: description: The root period every amount in the tenant is denominated in. enum: - PERIOD_KIND_UNSPECIFIED - PERIOD_KIND_DAILY - PERIOD_KIND_WEEKLY - PERIOD_KIND_MONTHLY - PERIOD_KIND_QUARTERLY - PERIOD_KIND_YEARLY type: string x-speakeasy-unknown-values: allow tenantId: description: The tenantId field. type: string updatedAt: format: date-time type: - string - 'null' title: Fund Policy type: object x-speakeasy-name-override: FundPolicy c1.models.funds.v1.SpendLimit: description: > SpendLimit is the three-way behavior fork. Which arms are legal depends on the scope carrying it; pkg/funds enforces that matrix, not the schema, because one SpendControls shape is shared by every scope. This message contains a oneof named kind. Only a single field of the following list may be set at a time: - unlimited - amount - blocked properties: amount: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.SpendLimitAmount' - type: 'null' blocked: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.SpendLimitBlocked' - type: 'null' unlimited: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.SpendLimitUnlimited' - type: 'null' title: Spend Limit type: object x-speakeasy-name-override: SpendLimit c1.models.funds.v1.SpendControls: description: |- SpendControls is the one control shape carried by every authority scope. Per-row resolution, identical everywhere: suspension present -> deny; unexpired extension -> extension.limit; limit present -> limit; otherwise this row states no opinion and resolution falls through. Not a oneof: two transitions need the losing field to survive. Unsuspending restores the limit it froze, and a lapsed extension falls back to its base rather than to the next layer. Pinned by TestControlsCoPresenceSurvivesEveryTransition in pkg/funds. properties: extension: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.SpendExtension' - type: 'null' limit: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.SpendLimit' - type: 'null' period: description: |- Only valid together with limit: a period without its amount would reinterpret some other layer's number in a cadence that layer never agreed to. enum: - PERIOD_KIND_UNSPECIFIED - PERIOD_KIND_DAILY - PERIOD_KIND_WEEKLY - PERIOD_KIND_MONTHLY - PERIOD_KIND_QUARTERLY - PERIOD_KIND_YEARLY type: string x-speakeasy-unknown-values: allow suspension: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.SpendSuspension' - type: 'null' title: Spend Controls type: object x-speakeasy-name-override: SpendControls c1.models.funds.v1.SpendLimitAmount: description: SpendLimitAmount caps spend at money per resolved period. properties: money: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.Money' - type: 'null' title: Spend Limit Amount type: object x-speakeasy-name-override: SpendLimitAmount c1.models.funds.v1.SpendLimitBlocked: description: >- SpendLimitBlocked refuses supply at this scope. Distinct from suspension: blocked is a stated policy posture, suspension is a reversible freeze that preserves the numbers underneath it. title: Spend Limit Blocked type: object x-speakeasy-name-override: SpendLimitBlocked c1.models.funds.v1.SpendLimitUnlimited: description: |- SpendLimitUnlimited is a tracking limit: full accounting, no admission condition. The maximum element, so an unlimited default makes grant rules no-ops. title: Spend Limit Unlimited type: object x-speakeasy-name-override: SpendLimitUnlimited c1.models.funds.v1.SpendExtension: description: |- SpendExtension replaces the row's total with a temporary one until expires_at. It never changes the period, and it never expresses a refusal — a temporary refusal is a SpendSuspension. properties: expiresAt: format: date-time type: - string - 'null' limit: oneOf: - $ref: '#/components/schemas/c1.models.funds.v1.SpendLimit' - type: 'null' reason: description: >- Subject-visible: "why do I have this bump". Mutation rationale rides the history change_reason annotation instead. type: string title: Spend Extension type: object x-speakeasy-name-override: SpendExtension c1.models.funds.v1.SpendSuspension: description: >- SpendSuspension freezes a scope without erasing the limit it must restore on unsuspend, which is why it lives beside the SpendLimit oneof rather than inside it. properties: reason: description: The reason field. type: string suspendedAt: format: date-time type: - string - 'null' title: Spend Suspension type: object x-speakeasy-name-override: SpendSuspension c1.models.funds.v1.Money: description: >- Money is wire-compatible with google.type.Money field-for-field, so the public API converts with a field copy. Declared here rather than imported because protoc-gen-pgdb mirrors a nested message by calling its generated DBReflect, which only exists for messages this repo generates. properties: currencyCode: description: >- ISO 4217 currency code. Must equal the tenant's FundPolicy.currency_code. type: string nanos: description: >- Nano-unit remainder, 0 <= nanos < 10^9. Non-negative for the same reason as units, which also keeps the (units, nanos) pair unambiguous. format: int32 type: integer units: description: >- Non-negative — grants, never debts — and bounded so units * 10^9 + nanos always fits int64. Without the ceiling a large value wraps positive and installs a limit nobody granted. The pair check spans two fields, so pkg/funds re-checks it on every conversion. format: int64 type: string title: Money type: object x-speakeasy-name-override: Money securitySchemes: bearerAuth: scheme: bearer type: http oauth: description: >- This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187) function. flows: clientCredentials: scopes: {} tokenUrl: /auth/v1/token type: oauth2 ````