> ## Documentation Index > Fetch the complete documentation index at: https://docs.watchdog.no/llms.txt > Use this file to discover all available pages before exploring further. # Create a shared team > Create a shared team with a trimmed name of 1–100 characters and an optional saved filter. Names are unique case-sensitively within the organization. Optional initial user_ids are validated and added atomically; an empty team remains valid. An omitted or null filter contributes no matches. Both ordinary organization members and admins can manage teams with Write access. Repeating creation returns a name conflict; no idempotency key is required. Team filters and membership never grant resource access. ## OpenAPI ````yaml /openapi-preview.json post /v1/teams openapi: 3.1.0 info: title: Watchdog API (preview) version: 1.0.0 description: >- Development preview for agreements, price items, document relationships, canonical invoices, alerts and alert topics, claims and attached alerts, shared entity activity and comments, Document uploads, invoice imports, explicit invoice-agreement matching, and workflow runs. This contract is under development and is not served by api.watchdog.no. Request bodies are limited to 2 MiB (2,097,152 bytes), including all JSON fields and line data, except POST /v1/support/contact which permits 32 MiB for base64 attachments. File bytes are uploaded directly to storage. The existing public REST service retains its separate contract. servers: - url: http://localhost:3500 description: Local development Worker security: [] paths: /v1/teams: post: tags: - Teams summary: Create a shared team description: >- Create a shared team with a trimmed name of 1–100 characters and an optional saved filter. Names are unique case-sensitively within the organization. Optional initial user_ids are validated and added atomically; an empty team remains valid. An omitted or null filter contributes no matches. Both ordinary organization members and admins can manage teams with Write access. Repeating creation returns a name conflict; no idempotency key is required. Team filters and membership never grant resource access. operationId: createTeam parameters: - name: X-Organization-Id in: header required: false schema: type: string description: >- Required for personal API keys. Target one organization you have access to. Migrated keys may omit it to use their original organization. For Clerk sessions, it must match the active organization. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateTeam' responses: '201': description: Created shared team. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. Location: schema: type: string required: false description: >- Relative resource URL. Present on synchronous resource creation and accepted workflow admissions or replays; absent for a known primary-file duplicate. content: application/json: schema: $ref: '#/components/schemas/Team' '400': description: >- Invalid request format, parameters, or body. Details contain up to 20 actionable field errors; the complete encoded request body must be at most 2 MiB (2,097,152 bytes). headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. content: application/json: schema: $ref: '#/components/schemas/Error_validation_error' example: error: code: validation_error message: >- Invalid request format, parameters, or body. Details contain up to 20 actionable field errors; the complete encoded request body must be at most 2 MiB (2,097,152 bytes). request_id: req_example '401': description: Missing or invalid bearer credential. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. WWW-Authenticate: schema: type: string required: false description: Bearer authentication challenge, when supplied. content: application/json: schema: $ref: '#/components/schemas/Error_invalid_token' example: error: code: invalid_token message: Missing or invalid bearer credential. request_id: req_example '403': description: >- Access denied: forbidden, token_disabled, organization_required, insufficient_role, or mfa_required. Check the error code and effective permissions. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. content: application/json: schema: $ref: >- #/components/schemas/Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required example: error: code: forbidden message: >- Access denied: forbidden, token_disabled, organization_required, insufficient_role, or mfa_required. Check the error code and effective permissions. request_id: req_example '404': description: The resource does not exist in the current organization. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. content: application/json: schema: $ref: '#/components/schemas/Error_not_found' example: error: code: not_found message: The resource does not exist in the current organization. request_id: req_example '409': description: >- A shared team with this exact case-sensitive name already exists in the organization. The entire write is rolled back. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. content: application/json: schema: $ref: '#/components/schemas/Error_conflict' example: error: code: conflict message: >- A shared team with this exact case-sensitive name already exists in the organization. The entire write is rolled back. request_id: req_example '429': description: The IP or authenticated credential exceeded its request limit. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. Retry-After: schema: type: string example: '60' required: true description: Seconds to wait before retrying the request. content: application/json: schema: $ref: '#/components/schemas/Error_rate_limit_exceeded' example: error: code: rate_limit_exceeded message: >- The IP or authenticated credential exceeded its request limit. request_id: req_example '500': description: >- Unexpected server failure. Include the request ID when contacting support. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. content: application/json: schema: $ref: '#/components/schemas/Error_internal_error' example: error: code: internal_error message: >- Unexpected server failure. Include the request ID when contacting support. request_id: req_example '503': description: >- Authentication infrastructure is unavailable or rate limited. Honor Retry-After when provided. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. Retry-After: schema: type: string example: '60' required: true description: Seconds to wait before retrying the request. content: application/json: schema: $ref: '#/components/schemas/Error_service_unavailable' example: error: code: service_unavailable message: >- Authentication infrastructure is unavailable or rate limited. Honor Retry-After when provided. request_id: req_example security: - ApiKeyBearer: [] - ClerkSessionBearer: [] components: schemas: CreateTeam: type: object properties: name: type: string minLength: 1 maxLength: 100 filter: type: - object - 'null' properties: schema_version: type: number enum: - 1 root: $ref: '#/components/schemas/TeamFilterRoot' required: - schema_version - root additionalProperties: false description: >- Omit to preserve the filter on PATCH, send null to clear it, or supply a complete version-1 definition to replace it. No saved filter matches no records. user_ids: type: array items: type: string minLength: 1 maxLength: 255 maxItems: 100 required: - name additionalProperties: false Team: type: object properties: id: type: string format: uuid name: type: string references: type: array items: type: object properties: id: type: string format: uuid name: type: - string - 'null' missing: type: boolean type: type: string enum: - supplier - recipient - agreement - agreement_tag required: - id - name - missing - type filter: $ref: '#/components/schemas/StoredSubscriptionFilter' created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - name - filter - created_at - updated_at - references Error_validation_error: type: object properties: error: type: object properties: code: type: string enum: - validation_error message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_invalid_token: type: object properties: error: type: object properties: code: type: string enum: - invalid_token message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required: type: object properties: error: type: object properties: code: type: string enum: - forbidden - token_disabled - organization_required - insufficient_role - mfa_required message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_not_found: type: object properties: error: type: object properties: code: type: string enum: - not_found message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_conflict: type: object properties: error: type: object properties: code: type: string enum: - conflict message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_rate_limit_exceeded: type: object properties: error: type: object properties: code: type: string enum: - rate_limit_exceeded message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_internal_error: type: object properties: error: type: object properties: code: type: string enum: - internal_error message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_service_unavailable: type: object properties: error: type: object properties: code: type: string enum: - service_unavailable message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error TeamFilterRoot: type: object properties: combinator: type: string enum: - and - or children: type: array items: anyOf: - $ref: '#/components/schemas/TeamReferenceCondition' - $ref: '#/components/schemas/TeamExactTextCondition' - $ref: '#/components/schemas/TeamContainsCondition' - $ref: '#/components/schemas/TeamNumberCondition' - $ref: '#/components/schemas/TeamDateCondition' - $ref: '#/components/schemas/TeamRelativeDateCondition' - $ref: '#/components/schemas/TeamFilterGroupLevel2' minItems: 1 maxItems: 20 required: - combinator - children additionalProperties: false StoredSubscriptionFilter: description: >- Saved subscription filter JSON, shared by teams and personal notification sources. Teams return it verbatim, including null or invalid legacy definitions; notification sources include only usable filters. Use TeamFilterDefinition to author a replacement. TeamReferenceCondition: type: object properties: field: type: string enum: - supplier.id - recipient.id - agreement.id - agreement.tag op: type: string enum: - is - is_not - is_any_of - is_none_of value: anyOf: - type: string format: uuid - type: array items: type: string format: uuid minItems: 1 maxItems: 100 required: - field - op - value additionalProperties: false TeamExactTextCondition: type: object properties: field: type: string enum: - supplier.country - invoice.currency - invoice.reference - invoice.delivery_address op: type: string enum: - is - is_not - is_any_of - is_none_of value: anyOf: - type: string minLength: 1 - type: array items: type: string minLength: 1 minItems: 1 maxItems: 100 required: - field - op - value additionalProperties: false TeamContainsCondition: type: object properties: field: type: string enum: - supplier.country - invoice.currency - invoice.reference - invoice.delivery_address op: type: string enum: - contains - not_contains value: type: string minLength: 1 required: - field - op - value additionalProperties: false TeamNumberCondition: type: object properties: field: type: string enum: - invoice.amount op: type: string enum: - eq - gt - gte - lt - lte value: anyOf: - type: number - type: string pattern: ^-?\d+(\.\d+)?$ required: - field - op - value additionalProperties: false TeamDateCondition: type: object properties: field: type: string enum: - agreement.expiration_date - invoice.issued_date op: type: string enum: - 'on' - before - on_or_before - after - on_or_after value: type: string format: date required: - field - op - value additionalProperties: false TeamRelativeDateCondition: type: object properties: field: type: string enum: - agreement.expiration_date - invoice.issued_date op: type: string enum: - within value: type: string enum: - last_30_days - last_90_days - last_365_days - expiring_30_days - expiring_60_days - expiring_90_days required: - field - op - value additionalProperties: false TeamFilterGroupLevel2: type: object properties: combinator: type: string enum: - and - or children: type: array items: anyOf: - $ref: '#/components/schemas/TeamReferenceCondition' - $ref: '#/components/schemas/TeamExactTextCondition' - $ref: '#/components/schemas/TeamContainsCondition' - $ref: '#/components/schemas/TeamNumberCondition' - $ref: '#/components/schemas/TeamDateCondition' - $ref: '#/components/schemas/TeamRelativeDateCondition' - $ref: '#/components/schemas/TeamFilterGroupLevel3' minItems: 1 maxItems: 20 required: - combinator - children additionalProperties: false TeamFilterGroupLevel3: type: object properties: combinator: type: string enum: - and - or children: type: array items: $ref: '#/components/schemas/TeamFilterCondition' minItems: 1 maxItems: 20 required: - combinator - children additionalProperties: false TeamFilterCondition: anyOf: - $ref: '#/components/schemas/TeamReferenceCondition' - $ref: '#/components/schemas/TeamExactTextCondition' - $ref: '#/components/schemas/TeamContainsCondition' - $ref: '#/components/schemas/TeamNumberCondition' - $ref: '#/components/schemas/TeamDateCondition' - $ref: '#/components/schemas/TeamRelativeDateCondition' securitySchemes: ApiKeyBearer: type: http scheme: bearer description: >- Personal API key. Send X-Organization-Id. The required cumulative level is listed in x-watchdog-permission. ClerkSessionBearer: type: http scheme: bearer description: Clerk session with an active organization. ````