> ## Documentation Index > Fetch the complete documentation index at: https://interfere.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # tiers create > Creates a workspace company tier. Names are trimmed, case-sensitive and unique within the workspace; the shade defaults to gray. Requires tier write permission. ## OpenAPI ````yaml https://api.interfere.com/openapi.json post /v3/workspaces/{workspaceSlug}/tiers openapi: 3.0.4 info: title: Interfere API termsOfService: https://interfere.com/legal/terms-of-service contact: email: support@interfere.com name: Interfere Support url: https://interfere.com/~/*/settings/support license: name: All Rights Reserved url: https://interfere.com/legal/terms-of-service description: >- Register builds, ingest telemetry, and inspect application issues. Build operations authenticate with a secret app key; SDK ingestion uses a publishable app key. Dashboard operations require a Clerk session. Authentication alternatives are listed on each operation. Retry only when the operation contract permits it, preserving the original idempotency key. version: 3.0.0 servers: - url: https://api.interfere.com description: This environment security: [] tags: - name: Releases description: Build registration and source-map uploads - name: Sessions description: Session identity, activity, and events - name: tenants x-displayName: Companies - name: tiers externalDocs: url: https://interfere.com/docs description: Interfere Documentation paths: /v3/workspaces/{workspaceSlug}/tiers: post: tags: - tiers summary: tiers create description: >- Creates a workspace company tier. Names are trimmed, case-sensitive and unique within the workspace; the shade defaults to gray. Requires tier write permission. operationId: tiers_create parameters: - name: workspaceSlug in: path required: true schema: type: string minLength: 1 requestBody: required: true content: application/json: schema: type: object properties: value: type: string minLength: 1 maxLength: 100 shade: enum: - blue - gray - grass - purple - red type: string default: gray required: - value responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CreateTenantTierResponse' '400': $ref: '#/components/responses/RpcValidationError' '401': $ref: >- #/components/responses/ErrorResponse_d7174de43f943d10193d5f31cc4615acb6d01e6a15ef9a1a861235cb9792319b '403': $ref: >- #/components/responses/ErrorResponse_10ef468de4a2f3d5e1e4a4bcd9c19369a4c535898d4ecea2b48444857aece895 '404': $ref: >- #/components/responses/ErrorResponse_aacd31107d1b82f7d854a3aa7c98c401a41a182720fd213babe309171722e17c '409': $ref: >- #/components/responses/ErrorResponse_5781de88319291b20e05f2d160a87a790c96fcd3e79d8d29a35a4fc99b33ed73 '503': $ref: >- #/components/responses/ErrorResponse_b7d254f6bd68a887b2398a1b58fb8fe3913110d7236a6e4540d7d2aa990fb12b security: - clerkSession: [] components: schemas: CreateTenantTierResponse: type: object properties: value: type: string minLength: 1 maxLength: 100 shade: enum: - blue - gray - grass - purple - red type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - value - shade - createdAt - updatedAt additionalProperties: false RpcUnexpectedError: type: object properties: defined: type: boolean enum: - false code: type: string status: type: number message: type: string data: {} required: - defined - code - status - message responses: RpcValidationError: description: Request parameters or body failed validation content: application/json: schema: $ref: '#/components/schemas/RpcUnexpectedError' ErrorResponse_d7174de43f943d10193d5f31cc4615acb6d01e6a15ef9a1a861235cb9792319b: description: Missing or invalid credentials content: application/json: schema: oneOf: - type: object properties: defined: type: boolean enum: - true code: type: string enum: - AUTH_MISSING status: type: integer enum: - 401 message: type: string default: Request is missing session credentials. data: {} required: - defined - code - status - message - type: object properties: defined: type: boolean enum: - true code: type: string enum: - AUTH_SESSION_INVALID status: type: integer enum: - 401 message: type: string default: Session token is missing, expired, or not valid here. data: {} required: - defined - code - status - message - type: object properties: defined: type: boolean enum: - true code: type: string enum: - AUTH_ORG_REQUIRED status: type: integer enum: - 401 message: type: string default: An active workspace session is required. data: {} required: - defined - code - status - message - $ref: '#/components/schemas/RpcUnexpectedError' ErrorResponse_10ef468de4a2f3d5e1e4a4bcd9c19369a4c535898d4ecea2b48444857aece895: description: Access denied content: application/json: schema: oneOf: - type: object properties: defined: type: boolean enum: - true code: type: string enum: - NETWORK_ACCESS_DENIED status: type: integer enum: - 403 message: type: string default: >- This network is not allowed to access the workspace. Connect to an allowed network and try again. data: {} required: - defined - code - status - message - type: object properties: defined: type: boolean enum: - true code: type: string enum: - WORKSPACE_ACCESS_DENIED status: type: integer enum: - 403 message: type: string default: Workspace access is unavailable for this session. data: {} required: - defined - code - status - message - $ref: '#/components/schemas/RpcUnexpectedError' ErrorResponse_aacd31107d1b82f7d854a3aa7c98c401a41a182720fd213babe309171722e17c: description: Resource not found content: application/json: schema: oneOf: - type: object properties: defined: type: boolean enum: - true code: type: string enum: - WORKSPACE_NOT_FOUND status: type: integer enum: - 404 message: type: string default: Workspace not found. data: {} required: - defined - code - status - message - $ref: '#/components/schemas/RpcUnexpectedError' ErrorResponse_5781de88319291b20e05f2d160a87a790c96fcd3e79d8d29a35a4fc99b33ed73: description: Request conflicts with current state content: application/json: schema: oneOf: - type: object properties: defined: type: boolean enum: - true code: type: string enum: - TIER_EXISTS status: type: integer enum: - 409 message: type: string default: A tier with this name already exists in the workspace. data: {} required: - defined - code - status - message - $ref: '#/components/schemas/RpcUnexpectedError' ErrorResponse_b7d254f6bd68a887b2398a1b58fb8fe3913110d7236a6e4540d7d2aa990fb12b: description: Service temporarily unavailable; retry after the indicated delay content: application/json: schema: oneOf: - type: object properties: defined: type: boolean enum: - true code: type: string enum: - NETWORK_ACCESS_UNAVAILABLE status: type: integer enum: - 503 message: type: string default: Network access could not be checked. Try again shortly. data: {} required: - defined - code - status - message - type: object properties: defined: type: boolean enum: - true code: type: string enum: - OPERATION_UNAVAILABLE status: type: integer enum: - 503 message: type: string default: Operation is temporarily unavailable. data: {} required: - defined - code - status - message - $ref: '#/components/schemas/RpcUnexpectedError' headers: Retry-After: $ref: '#/components/headers/RetryAfter' headers: RetryAfter: description: Seconds to wait before retrying this request schema: type: string pattern: ^[0-9]+$ example: '30' securitySchemes: clerkSession: description: >- Clerk session or delegated OAuth access token of an Interfere user. Workspace routes also accept API keys with explicit permission scopes. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.