> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zivio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Project



## OpenAPI

````yaml /api-reference/v4/openapi.json get /projects/{id}
openapi: 3.1.0
info:
  title: API V4
  version: '4'
  description: >-
    OAuth 2.0 secured API. Obtain an access token using client credentials to
    access protected endpoints. The regional endpoints listed below serve every
    Zivio organisation, so each request — including the token request — must
    carry a `zivio-tenant-id` header identifying yours. Requests without it are
    rejected with a 404 before any token is checked.
  contact:
    name: API Support
    email: support@zivio.com
servers:
  - url: https://api.zivio.net/api/v4
    description: Global API Router
  - url: https://api.eu.zivio.net/api/v4
    description: EU Data Region
  - url: https://api.uk.zivio.net/api/v4
    description: UK Data Region
  - url: https://api.us.zivio.net/api/v4
    description: US Data Region
security:
  - oauth2: []
    tenantId: []
paths:
  /projects/{id}:
    get:
      tags:
        - Projects
      summary: Get a Project
      operationId: getProjectsById
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
          description: Project ID
          example: 123
      responses:
        '200':
          description: Project details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Project'
              example:
                id: 101
                title: Website Redesign Project
                description: Complete redesign of corporate website with modern UX
                state: pending
                additional_notes: Additional information and context for this record.
                skill_category:
                  id: 101
                  name: Acme Corporation
                  code: Example code
                  slug: Example slug
                  precedence: 101
                  parent_id: 501
                  parent_name: Example parent_name
                  parent_slug: Example parent_slug
                skill_subcategory:
                  id: 101
                  name: Acme Corporation
                  code: Example code
                  slug: Example slug
                  precedence: 101
                  parent_id: 501
                  parent_name: Example parent_name
                  parent_slug: Example parent_slug
                skill_category_tier3:
                  id: 101
                  name: Acme Corporation
                  code: Example code
                  slug: Example slug
                  precedence: 101
                  parent_id: 501
                  parent_name: Example parent_name
                  parent_slug: Example parent_slug
                skills:
                  - id: 101
                    name: Acme Corporation
                    slug: Example slug
                  - id: 102
                    name: Global Services Ltd
                    slug: Example slug
                talent_pool_id: 501
                type: standard
                posting_type: public
                bids_count: 5
                submission_deadline: '2024-01-16T10:30:00+00:00'
                submission_deadline_time_zone: Europe/London
                ccy: GBP
                fee_methodology: supplier_absorbed
                fee_schedule_id: 501
                award_type: competition
                risk_level_id: 501
                is_template: false
                quality_score_allocation_percentage: 50
                cost_score_allocation_percentage: 50
                award_suppliers:
                  - direct
                  - panel
                approved: true
                submitted_at: '2024-01-16T10:30:00+00:00'
                approved_at: '2024-01-16T10:30:00+00:00'
                hired_at: '2024-01-16T10:30:00+00:00'
                start_date: '2024-03-08'
                due_on: '2024-01-16'
                original_due_on: '2024-01-16'
                ended_at: '2024-01-16T10:30:00+00:00'
                closed_at: '2024-01-16T10:30:00+00:00'
                auto_close_at: '2024-01-16T10:30:00+00:00'
                halted_comment: null
                cancellation_reason_id: 501
                cancellation_other_reason: null
                cancelled_by:
                  id: 101
                  first_name: Demo
                  last_name: User
                  email: user1@example.com
                  org_id: 501
                  org_name: Acme Corporation
                cancelled_at: '2024-01-16T10:30:00+00:00'
                completed_by:
                  id: 101
                  first_name: Demo
                  last_name: User
                  email: user1@example.com
                  org_id: 501
                  org_name: Acme Corporation
                closed_by:
                  id: 101
                  first_name: Demo
                  last_name: User
                  email: user1@example.com
                  org_id: 501
                  org_name: Acme Corporation
                visibility: visible
                bafo_submission_deadline: '2024-01-16T10:30:00+00:00'
                bid_round: 101
                original_project_id: 501
                location:
                  type: location
                  label: London, UK
                target_cost:
                  cents: 150000
                  currency: GBP
                budget:
                  cents: 150000
                  currency: GBP
                original_budget:
                  cents: 150000
                  currency: GBP
                rate:
                  cents: 150000
                  currency: GBP
                original_rate:
                  cents: 150000
                  currency: GBP
                fee: '1500.00'
                markup: '1500.00'
                estimated_savings:
                  cents: 150000
                  currency: GBP
                projected_recognized_savings:
                  cents: 150000
                  currency: GBP
                payment_terms_in_days: 30
                client_payment_terms_in_days: 30
                permit_supplier_defined_milestones: null
                supplier_defined_milestones: null
                client_defined_milestones_mandatory: null
                invoices_cis: null
                cis_end_user_client: null
                is_child: false
                is_parent: false
                custom_fields:
                  department: Engineering
                  priority: high
                  cost_code: CC-001
                badges:
                  - urgent
                  - featured
                project_screening_questions:
                  - question: Years of experience?
                    required: true
                  - question: Available start date?
                    required: false
                client:
                  id: 101
                  first_name: Demo
                  last_name: User
                  email: user1@example.com
                  org_id: 501
                  org_name: Acme Corporation
                administrator:
                  id: 101
                  first_name: Demo
                  last_name: User
                  email: user1@example.com
                  org_id: 501
                  org_name: Acme Corporation
                client_org:
                  id: 101
                  name: Acme Corporation
                  is_external_client: true
                cost_centers:
                  - cost_center_id: 501
                    allocation_percentage: '1500.00'
                    name: Acme Corporation
                    code: null
                    admin_custom_fields: null
                    project_id: 501
                  - cost_center_id: 502
                    allocation_percentage: '1500.00'
                    name: Global Services Ltd
                    code: null
                    admin_custom_fields: null
                    project_id: 502
                milestones:
                  - id: 101
                    title: Website Redesign Project
                    status: submitted
                    client_suggested: false
                    close_project: false
                    comments: Additional information and context for this record.
                    details: Additional information and context for this record.
                    due_on: '2024-01-16'
                    project_summary: >-
                      Website Redesign Project - Complete redesign of corporate
                      website with modern UX
                    mandatory: false
                    notes: Additional information and context for this record.
                    original_id: 501
                    original_rate:
                      cents: 150000
                      currency: GBP
                    purchase_order_line_id: 501
                    rate:
                      cents: 150000
                      currency: GBP
                    submitted_at: '2024-01-16T10:30:00+00:00'
                    interim_valuation_date: '2024-01-16T10:30:00+00:00'
                    tiered_markup_fee:
                      cents: 150000
                      currency: GBP
                    children:
                      - 201
                      - 202
                    parents:
                      - 201
                      - 202
                    custom_fields:
                      department: Engineering
                      priority: high
                      cost_code: CC-001
                    created_at: '2024-01-16T10:30:00+00:00'
                    updated_at: '2024-01-16T10:30:00+00:00'
                    project_id: 501
                    final_claim: 'false'
                    delivered_on: '2024-01-16'
                    approved_by:
                      id: 101
                      first_name: Demo
                      last_name: User
                      email: user1@example.com
                      org_id: 501
                      org_name: Acme Corporation
                    rejected_by:
                      id: 101
                      first_name: Demo
                      last_name: User
                      email: user1@example.com
                      org_id: 501
                      org_name: Acme Corporation
                    level_1_approved_by:
                      id: 101
                      first_name: Demo
                      last_name: User
                      email: user1@example.com
                      org_id: 501
                      org_name: Acme Corporation
                  - id: 102
                    title: Mobile App Development
                    status: approved
                    client_suggested: false
                    close_project: false
                    comments: Additional information and context for this record.
                    details: Additional information and context for this record.
                    due_on: '2024-01-17'
                    project_summary: >-
                      Website Redesign Project - Complete redesign of corporate
                      website with modern UX
                    mandatory: false
                    notes: Additional information and context for this record.
                    original_id: 502
                    original_rate:
                      cents: 300000
                      currency: GBP
                    purchase_order_line_id: 502
                    rate:
                      cents: 300000
                      currency: GBP
                    submitted_at: '2024-01-17T10:30:00+00:00'
                    interim_valuation_date: '2024-01-17T10:30:00+00:00'
                    tiered_markup_fee:
                      cents: 300000
                      currency: GBP
                    children:
                      - 202
                      - 203
                    parents:
                      - 202
                      - 203
                    custom_fields:
                      department: Engineering
                      priority: high
                      cost_code: CC-001
                    created_at: '2024-01-17T10:30:00+00:00'
                    updated_at: '2024-01-17T10:30:00+00:00'
                    project_id: 502
                    final_claim: 'true'
                    delivered_on: '2024-01-17'
                    approved_by:
                      id: 102
                      first_name: Jane
                      last_name: Smith
                      email: user2@example.com
                      org_id: 502
                      org_name: Global Services Ltd
                    rejected_by:
                      id: 102
                      first_name: Jane
                      last_name: Smith
                      email: user2@example.com
                      org_id: 502
                      org_name: Global Services Ltd
                    level_1_approved_by:
                      id: 102
                      first_name: Jane
                      last_name: Smith
                      email: user2@example.com
                      org_id: 502
                      org_name: Global Services Ltd
                supplier:
                  id: 101
                  name: Acme Corporation
                  email: user1@example.com
                  vetting_status: PASSED
                  tax_number: Example tax_number
                  tax_registered: true
                created_at: '2024-01-16T10:30:00+00:00'
                updated_at: '2024-01-16T10:30:00+00:00'
                project_matches_count: 5
                project_line_items:
                  - id: 101
                    name: Acme Corporation
                    manufacturer_name: Example manufacturer_name
                    manufacturer_part_number: Example manufacturer_part_number
                    uom: null
                    item: null
                    item_type: service
                    price:
                      cents: 150000
                      currency: GBP
                    quantity: '1500.00'
                    net_total_price: null
                    quantity_delivered: null
                    quantity_undelivered: null
                    custom_fields:
                      department: Engineering
                      priority: high
                      cost_code: CC-001
                    created_at: '2024-01-16T10:30:00+00:00'
                    updated_at: '2024-01-16T10:30:00+00:00'
                    project_id: 501
                  - id: 102
                    name: Global Services Ltd
                    manufacturer_name: Example manufacturer_name
                    manufacturer_part_number: Example manufacturer_part_number
                    uom: null
                    item: null
                    item_type: item
                    price:
                      cents: 300000
                      currency: GBP
                    quantity: '1500.00'
                    net_total_price: null
                    quantity_delivered: null
                    quantity_undelivered: null
                    custom_fields:
                      department: Engineering
                      priority: high
                      cost_code: CC-001
                    created_at: '2024-01-17T10:30:00+00:00'
                    updated_at: '2024-01-17T10:30:00+00:00'
                    project_id: 502
                award_criteria_groups:
                  - id: 101
                    name: Acme Corporation
                    group_type: Example group_type
                    weighting: 101
                    has_sub_criteria: true
                    position: 101
                    project_quality_criteria: []
                  - id: 102
                    name: Global Services Ltd
                    group_type: Example group_type
                    weighting: 102
                    has_sub_criteria: true
                    position: 102
                    project_quality_criteria: []
        '401':
          description: >-
            Unauthorized - the access token is missing, expired, revoked or
            malformed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: invalid_token
                error_description: >-
                  The access token provided is expired, revoked, malformed, or
                  invalid for other reasons
        '403':
          description: Forbidden - insufficient scope or access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                insufficient_scope:
                  summary: Token lacks required scope
                  value:
                    error: insufficient_scope
                    error_description: >-
                      The request requires higher privileges than provided by
                      the access token
                    required_scope: projects:read
                    provided_scopes:
                      - welcome:read
                access_denied:
                  summary: User cannot access this resource
                  value:
                    message: You do not have permission to access this resource
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Record not found
      security:
        - oauth2:
            - projects:read
          tenantId: []
components:
  schemas:
    Project:
      type: object
      properties:
        id:
          type: integer
        title:
          type: string
        description:
          type: string
        state:
          type: string
          enum:
            - draft
            - pending
            - new
            - halted
            - in_progress
            - work_completed
            - cancelled
            - closed
            - superseded
            - bafo
          example: draft
        additional_notes:
          type: string
        skill_category:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedSkillCategory'
            - type: 'null'
        skill_subcategory:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedSkillCategory'
            - type: 'null'
        skill_category_tier3:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedSkillCategory'
            - type: 'null'
        skills:
          type: array
          items:
            $ref: '#/components/schemas/EmbeddedSkill'
        talent_pool_id:
          type: integer
        type:
          type: string
        posting_type:
          type: string
        bids_count:
          type: integer
        submission_deadline:
          type: string
        submission_deadline_time_zone:
          type: string
        ccy:
          type: string
        fee_methodology:
          type: string
          enum:
            - markup
            - supplier_absorbed
            - tiered_markup
            - supplier_absorbed_itemized
            - markup_itemized
          example: markup
        fee_schedule_id:
          type: integer
        award_type:
          type: string
          enum:
            - direct_award
            - competition
          example: direct_award
        risk_level_id:
          type: integer
        is_template:
          type: boolean
          example: true
        quality_score_allocation_percentage:
          type: string
        cost_score_allocation_percentage:
          type: string
        award_suppliers:
          type: array
          items:
            type: string
        approved:
          type: boolean
          example: true
        submitted_at:
          type: string
        approved_at:
          type: string
        hired_at:
          type: string
        start_date:
          type: string
        due_on:
          type: string
        original_due_on:
          type: string
        ended_at:
          type: string
        closed_at:
          type: string
        auto_close_at:
          type: string
        halted_comment:
          type: string
        cancellation_reason_id:
          type: integer
        cancellation_other_reason:
          type: string
        cancelled_by:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedUser'
            - type: 'null'
        cancelled_at:
          type: string
        completed_by:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedUser'
            - type: 'null'
        closed_by:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedUser'
            - type: 'null'
        visibility:
          type: string
        bafo_submission_deadline:
          type: string
        bid_round:
          type: integer
        original_project_id:
          type: integer
        location:
          $ref: '#/components/schemas/EmbeddedLocation'
        target_cost:
          $ref: '#/components/schemas/Money'
        budget:
          $ref: '#/components/schemas/Money'
        original_budget:
          $ref: '#/components/schemas/Money'
        rate:
          $ref: '#/components/schemas/Money'
        original_rate:
          $ref: '#/components/schemas/Money'
        fee:
          type: string
        markup:
          type: string
        estimated_savings:
          $ref: '#/components/schemas/Money'
        projected_recognized_savings:
          $ref: '#/components/schemas/Money'
        payment_terms_in_days:
          type: integer
        client_payment_terms_in_days:
          type: integer
        permit_supplier_defined_milestones:
          type: string
        supplier_defined_milestones:
          type: string
        client_defined_milestones_mandatory:
          type: string
        invoices_cis:
          type: string
        cis_end_user_client:
          type: string
        is_child:
          type: boolean
          example: true
        is_parent:
          type: boolean
          example: true
        custom_fields:
          type: object
          additionalProperties:
            type: string
          description: Key-value pairs of custom field data
        badges:
          type: array
          items:
            type: string
        project_screening_questions:
          type: string
        client:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedUser'
            - type: 'null'
        administrator:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedUser'
            - type: 'null'
        client_org:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedOrg'
            - type: 'null'
        cost_centers:
          type: array
          items:
            $ref: '#/components/schemas/EmbeddedProjectCostCenter'
        milestones:
          type: array
          items:
            $ref: '#/components/schemas/Milestone'
        supplier:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedSupplier'
            - type: 'null'
        created_at:
          type: string
        updated_at:
          type: string
        project_matches_count:
          type: integer
        project_line_items:
          type: array
          items:
            $ref: '#/components/schemas/ProjectLineItem'
        award_criteria_groups:
          type: array
          items:
            $ref: '#/components/schemas/EmbeddedAwardCriteriaGroup'
    Error:
      type: object
      description: Error envelope returned by every non-2xx V4 response
      properties:
        error:
          type: string
          example: insufficient_scope
        error_description:
          type: string
        message:
          type: string
        details:
          type: object
          additionalProperties: true
        required_scope:
          type: string
          example: projects:read
        provided_scopes:
          type: array
          items:
            type: string
    EmbeddedSkillCategory:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        code:
          type: string
        slug:
          type: string
        precedence:
          type: integer
        parent_id:
          type: integer
        parent_name:
          type: string
        parent_slug:
          type: string
    EmbeddedSkill:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        slug:
          type: string
    EmbeddedUser:
      type: object
      properties:
        id:
          type: integer
        first_name:
          type: string
        last_name:
          type: string
        email:
          type: string
        org_id:
          type: integer
        org_name:
          type: string
    EmbeddedLocation:
      type: object
      properties:
        type:
          type: string
        code:
          type: string
        name:
          type: string
        address:
          oneOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
    Money:
      type: object
      properties:
        cents:
          type: integer
          example: 150000
        currency:
          type: string
          example: GBP
    EmbeddedOrg:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        is_external_client:
          type: boolean
          example: true
    EmbeddedProjectCostCenter:
      type: object
      properties:
        cost_center_id:
          type: integer
        allocation_percentage:
          type: string
        name:
          type: string
        code:
          type: string
        admin_custom_fields:
          type: object
          additionalProperties:
            type: string
          description: Key-value pairs of custom field data
        project_id:
          type: integer
    Milestone:
      type: object
      properties:
        id:
          type: integer
        title:
          type: string
        status:
          type: string
          enum:
            - open
            - submitted
            - approved
            - rejected
            - change_requested
            - on_hold
            - draft
            - cancelled
            - level_1_approved
            - closed
          example: open
        client_suggested:
          type: boolean
          example: true
        close_project:
          type: boolean
          example: true
        comments:
          type: string
        details:
          type: string
        due_on:
          type: string
        project_summary:
          type: string
        mandatory:
          type: boolean
          example: true
        notes:
          type: string
        original_id:
          type: integer
        original_rate:
          $ref: '#/components/schemas/Money'
        purchase_order_line_id:
          type: integer
        rate:
          $ref: '#/components/schemas/Money'
        submitted_at:
          type: string
        interim_valuation_date:
          type: string
        tiered_markup_fee:
          $ref: '#/components/schemas/Money'
        children:
          type: array
          items:
            type: integer
          description: Array of IDs
        parents:
          type: array
          items:
            type: integer
          description: Array of IDs
        custom_fields:
          type: object
          additionalProperties:
            type: string
          description: Key-value pairs of custom field data
        created_at:
          type: string
        updated_at:
          type: string
        project_id:
          type: integer
        final_claim:
          type: boolean
          example: true
        delivered_on:
          type: string
        approved_by:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedUser'
            - type: 'null'
        rejected_by:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedUser'
            - type: 'null'
        level_1_approved_by:
          oneOf:
            - $ref: '#/components/schemas/EmbeddedUser'
            - type: 'null'
    EmbeddedSupplier:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        email:
          type: string
        vetting_status:
          type: string
          enum:
            - NOT REGISTERED
            - PASSED
            - FAILED
            - PENDING
          example: NOT REGISTERED
        tax_number:
          type: string
        tax_registered:
          type: boolean
          example: true
    ProjectLineItem:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        manufacturer_name:
          type: string
        manufacturer_part_number:
          type: string
        uom:
          type: string
        item:
          type: string
        item_type:
          type: string
          enum:
            - item
            - service
          example: item
        price:
          $ref: '#/components/schemas/Money'
        quantity:
          type: string
        net_total_price:
          type: string
        quantity_delivered:
          type: string
        quantity_undelivered:
          type: string
        custom_fields:
          type: object
          additionalProperties:
            type: string
          description: Key-value pairs of custom field data
        created_at:
          type: string
        updated_at:
          type: string
        project_id:
          type: integer
    EmbeddedAwardCriteriaGroup:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        group_type:
          type: string
        weighting:
          type: integer
        has_sub_criteria:
          type: boolean
          example: true
        position:
          type: integer
        project_quality_criteria:
          type: array
          items:
            $ref: '#/components/schemas/EmbeddedProjectQualityCriterium'
    Address:
      type: object
      properties:
        id:
          type: integer
        line1:
          type: string
        line2:
          type: string
        city:
          type: string
        region:
          type: string
        postcode:
          type: string
        country_code:
          type: string
        formatted:
          type: string
    EmbeddedProjectQualityCriterium:
      type: object
      properties:
        id:
          type: integer
        description:
          type: string
        weighting:
          type: integer
  securitySchemes:
    oauth2:
      type: oauth2
      description: >-
        OAuth 2.0 client credentials. The access token from POST /oauth/token is
        sent as a bearer token. Request only the scopes you need.
      flows:
        clientCredentials:
          tokenUrl: https://api.zivio.net/api/v4/oauth/token
          scopes:
            bank_accounts:read: Read bank account details on suppliers and the org.
            catalogs:read: Read catalog items.
            cost_centers:read: Read cost center records.
            eoi_responses:read: Read responses to expressions of interest.
            eois:read: Read expressions of interest.
            offers:read: Read offers for projects.
            org_units:read: Read your organization unit hierarchy.
            org_users:read: Read members of your organization.
            resources:read: Read resource (worker) records.
            sales_invoices:read: Read invoices issued to clients.
            sales_milestones:read: Read milestones on sales engagements.
            skill_categories:read: Read the skill category taxonomy.
            skill_taxonomies:read: Read skill taxonomy structure.
            skills:read: Read individual skills.
            supplier_documents:read: Read documents uploaded by suppliers.
            supplier_lists:read: Read curated lists of suppliers.
            supplier_users:read: Read users belonging to supplier organizations.
            tax_types:read: Read configured tax types.
            users:read: Read user profiles.
            variation_orders:read: Read variation orders on projects.
            welcome:read: 'Required: confirms your identity to the application.'
            bid_evaluations:read: >-
              Read evaluation scorecards for bids, including criterion scores
              and quality, cost and total scores.
            bid_evaluations:write: >-
              Score bids against a project's quality criteria and override
              calculated cost scores.
            bids:read: Read bids submitted on projects.
            bids:write: >-
              Shortlist, select, eliminate and reinstate bids submitted on
              projects.
            invoices:read: Read invoices on projects.
            invoices:write: Create and update invoices.
            notes:read: Read notes on projects and EOIs.
            notes:write: Create and update notes on projects and EOIs.
            project_approvals:read: Read project approval workflows.
            project_approvals:write: Create and update project approval workflows.
            project_conversations:read: Read messages exchanged with suppliers on a project.
            project_conversations:write: Send messages to suppliers on a project.
            project_invitations:read: Read supplier invitations on projects.
            project_invitations:write: Invite suppliers to bid on projects.
            project_questions:read: Read supplier clarification questions on projects.
            project_questions:write: Answer and approve supplier clarification questions.
            projects:read: Read projects.
            projects:write: Create and update projects.
            milestones:read: Read milestones on projects.
            milestones:write: Create and update milestones.
            orgs:read: Read organization records.
            orgs:write: Create and update organization records.
            purchase_orders:read: Read purchase orders.
            purchase_orders:write: Create and update purchase orders.
            reviews:read: Read reviews left on suppliers.
            reviews:write: Create and update reviews.
            suppliers:read: Read supplier profiles.
            suppliers:write: Create and update supplier profiles.
            raw_scorecard_entries:write: Create and update raw scorecard entries.
            raw_scorecard_entries:read: Read raw scorecard entries.
            tasks:read: >-
              Read the acting user's task queue, including outstanding approvals
              and items to review.
            tasks:write: Complete and dismiss tasks in the acting user's task queue.
            act_as_user: >-
              Make requests as another user within the token holder's delegation
              boundary.
    tenantId:
      type: apiKey
      name: zivio-tenant-id
      in: header
      description: >-
        Your Zivio organisation identifier. The regional API endpoints serve
        every Zivio organisation, so each request must identify yours.

````