> ## Documentation Index > Fetch the complete documentation index at: https://docs.opennous.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Set the tier bands > Set where each tier starts for this workspace. Values run from 1 to 100 and must descend. Send `{ "reset": true }` to go back to the defaults. The bands apply to tiers Nous derives and to external scores sent without a tier. An account counts as a fit from the Tier 2 band up. Sets the score where each tier starts. The defaults are 85, 70, and 50. | Tier | Default band | The play | | - | - | - | | `tier_1` | 85 to 100 | Work by hand | | `tier_2` | 70 to 84 | Queue to automation | | `tier_3` | 50 to 69 | Nurture | | `not_icp` | Below 50 | Suppress | The bands apply to tiers OpenNous derives and to external scores you send without a `tier`. Send `{ "reset": true }` to go back to the defaults. An account counts as a fit from the Tier 2 band up. Read the current bands with `GET /v2/icp/tiers`. ## OpenAPI ````yaml PUT /v2/icp/tiers openapi: 3.1.0 info: title: OpenNous REST API version: 2.0.0 description: >- Read and write the OpenNous revenue context graph over HTTP. Authenticate with a workspace API key. servers: - url: https://api.opennous.cloud description: OpenNous Cloud security: - bearerAuth: [] - apiKeyHeader: [] tags: - name: People - name: Accounts - name: Deals - name: Notes - name: Attention - name: Insights - name: Enrich & score - name: Organization - name: Workflows - name: Webhooks description: >- Subscribe to events and have them pushed to your own stack, with the account record attached. - name: Usage paths: /v2/icp/tiers: put: tags: - Organization summary: Set the tier bands description: >- Set where each tier starts for this workspace. Values run from 1 to 100 and must descend. Send `{ "reset": true }` to go back to the defaults. The bands apply to tiers Nous derives and to external scores sent without a tier. An account counts as a fit from the Tier 2 band up. operationId: setIcpTiers requestBody: required: true content: application/json: schema: type: object properties: tier_1: type: integer minimum: 1 maximum: 100 tier_2: type: integer minimum: 1 maximum: 100 tier_3: type: integer minimum: 1 maximum: 100 reset: type: boolean description: >- `true` clears the workspace bands and goes back to the defaults. Send it alone. examples: set: summary: Set the bands value: tier_1: 80 tier_2: 60 tier_3: 40 reset: summary: Back to the defaults value: reset: true responses: '200': description: The bands now in effect. content: application/json: schema: type: object properties: tier_1: type: integer minimum: 1 maximum: 100 description: Lowest score that is Tier 1. tier_2: type: integer minimum: 1 maximum: 100 description: Lowest score that is Tier 2. tier_3: type: integer minimum: 1 maximum: 100 description: Lowest score that is Tier 3. Anything below is `not_icp`. source: type: string enum: - workspace - default example: tier_1: 80 tier_2: 60 tier_3: 40 source: workspace '400': description: A value is missing, outside 1 to 100, or the bands do not descend. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: invalid_tiers '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/UpgradeRequired' '403': $ref: '#/components/responses/ReadOnlyKey' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: schemas: Error: type: object description: >- Every error response. `error` is a stable machine code. Some errors add fields such as `detail`, `supported`, `max`, or `reason`. required: - error properties: error: type: string description: Machine-readable error code. detail: type: string description: Human-readable explanation, when there is one. additionalProperties: true responses: Unauthorized: description: Missing, unknown, or expired API key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing: summary: api_key_required value: error: api_key_required invalid: summary: invalid_api_key value: error: invalid_api_key expired: summary: api_key_expired value: error: api_key_expired detail: >- This API key has expired. Create or rotate a key to get a fresh one. UpgradeRequired: description: The workspace is past its monthly operations limit and grace window. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: upgrade_required reason: ops_limit_reached current_plan: starter upgrade_url: /settings?section=billing ReadOnlyKey: description: A read-only key called a write endpoint. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: read_only_key detail: >- This API key is read-only — it can read context but cannot record, modify, connect, or send. Use a read/write key for write operations. RateLimited: description: More than 600 requests in a minute on this key. headers: RateLimit-Limit: schema: type: integer description: Requests allowed per window. RateLimit-Remaining: schema: type: integer description: Requests left in the window. RateLimit-Reset: schema: type: integer description: Seconds until the window resets. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: rate_limited InternalError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: internal_error securitySchemes: bearerAuth: type: http scheme: bearer description: Workspace API key. Create one in **Settings → API keys**. apiKeyHeader: type: apiKey in: header name: X-API-Key description: The same key, sent as a header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.