Synack Tags API

openapi: 3.2.0
info:
  title: Synack Tags API
  contact:
    name: Synack Engineering
    email: engineering@synack.com
  version: '1.0'
  description: 'Operations tagged Tags across 4 of this provider''s published API definitions: synack-asset-discovery-openapi.yaml, synack-monolith-v1-openapi.yaml, synack-streaming-openapi.yaml, synack-tagging-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://client.synack.com/api/asset-discovery
  description: Commercial
- url: https://client.synack.us/api/asset-discovery
  description: FedRAMP (Medium)
- url: https://api.synack.com
  description: Commercial - V1 API
- url: https://api.synack.us
  description: FedRAMP (Medium) - V1 API
- url: https://client.synack.com/api/streaming
  description: Commercial
- url: https://client.synack.us/api/streaming
  description: FedRAMP (Medium)
- url: https://client.synack.com/api/tagging
  description: Commercial
- url: https://client.synack.us/api/tagging
  description: FedRAMP (Medium)
tags:
- name: Tags
  description: Tags applied to seeds and seed groups.
paths:
  /v1/organizations/{organizationUid}/seed-groups/{seedGroupUid}/tags/batchUpdate:
    parameters:
    - $ref: '#/components/parameters/OrganizationUIDPath'
    - $ref: '#/components/parameters/SeedGroupUIDPath'
    post:
      operationId: updateSeedGroupTags
      tags:
      - Tags
      description: 'Updates a seed groups tags.

        '
      x-mint:
        metadata:
          title: Update Seed Group Tags
      requestBody:
        description: 'Tags update.

          '
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchTagsUpdate'
      responses:
        '204':
          $ref: '#/components/responses/204NoContent'
        '400':
          $ref: '#/components/responses/400BadRequest'
        '401':
          $ref: '#/components/responses/401Unauthorized'
        '403':
          $ref: '#/components/responses/403Forbidden'
        '409':
          $ref: '#/components/responses/409Conflict'
        '413':
          $ref: '#/components/responses/413RequestEntityTooLarge'
        '422':
          $ref: '#/components/responses/422EntityNotProcessable'
        '500':
          $ref: '#/components/responses/500InternalServerError'
        '503':
          $ref: '#/components/responses/503ServiceUnavailable'
      security:
      - OAuth2:
        - assetdiscovery_ow
    servers:
    - url: https://client.synack.com/api/asset-discovery
      description: Commercial
    - url: https://client.synack.us/api/asset-discovery
      description: FedRAMP (Medium)
  /v1/vulnerability_tags:
    get:
      operationId: getVulnerabilityTags
      summary: Get vulnerability tags
      description: Retrieve a list of vulnerability tags
      tags:
      - Tags
      responses:
        '200':
          description: Vulnerability tags retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Tag_2'
        '401':
          description: Unauthorized
      security:
      - BearerAuth: []
      - BasicAuth: []
      - ApiKeyAuth: []
    post:
      operationId: createVulnerabilityTag
      summary: Create a vulnerability tag
      description: Create a new vulnerability tag
      tags:
      - Tags
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                  description: Name of the tag
      responses:
        '201':
          description: Tag created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tag_2'
        '400':
          description: Bad request
      security:
      - BearerAuth: []
      - BasicAuth: []
      - ApiKeyAuth: []
    servers:
    - url: https://api.synack.com
      description: Commercial - V1 API
    - url: https://api.synack.us
      description: FedRAMP (Medium) - V1 API
  /v1/vulnerability_tags/{id}:
    put:
      operationId: updateVulnerabilityTag
      summary: Update a vulnerability tag
      description: Update an existing vulnerability tag
      tags:
      - Tags
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Tag ID
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: New name for the tag
      responses:
        '200':
          description: Tag updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tag_2'
        '400':
          description: Bad request
        '404':
          description: Tag not found
      security:
      - BearerAuth: []
      - BasicAuth: []
      - ApiKeyAuth: []
    delete:
      operationId: deleteVulnerabilityTag
      summary: Delete a vulnerability tag
      description: Delete a vulnerability tag
      tags:
      - Tags
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Tag ID
      responses:
        '204':
          description: Tag deleted successfully
        '404':
          description: Tag not found
      security:
      - BearerAuth: []
      - BasicAuth: []
      - ApiKeyAuth: []
    servers:
    - url: https://api.synack.com
      description: Commercial - V1 API
    - url: https://api.synack.us
      description: FedRAMP (Medium) - V1 API
  /v1/assessment_tags:
    get:
      summary: Retrieve a list of assessments tags
      description: Retrieve all assessments tags defined by your organization including the number of assessments they are associated with.
      tags:
      - Tags
      responses:
        '200':
          description: A list of organization's assessments tags
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      format: int64
                    name:
                      type: string
                      description: custom assessment tag
                    count:
                      type: integer
                      format: int64
                      description: number of assessments the tag is associated with
                  required:
                  - id
                  - name
                  - count
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
      security:
      - BearerAuth: []
      - BasicAuth: []
      - ApiKeyAuth: []
    post:
      summary: Create a new assessment tag
      description: Create a new tag and associate it with an assessment. Only organization admins are able to create new tags.
      tags:
      - Tags
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Name of the tag
                assessment_id:
                  type: string
                  description: ID of the assessment to tag
              required:
              - name
              - assessment_id
      responses:
        '201':
          description: The newly created tag
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    format: int64
                  name:
                    type: string
                    description: custom assessment tag
                required:
                - id
                - name
        '400':
          description: Tag name is missing or is invalid (e.g. exists already)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
        '404':
          description: Requesting party is missing admin privileges or assessment not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
        '422':
          description: Tag creation failed unexpectedly
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
      security:
      - BearerAuth: []
      - BasicAuth: []
      - ApiKeyAuth: []
    servers:
    - url: https://api.synack.com
      description: Commercial - V1 API
    - url: https://api.synack.us
      description: FedRAMP (Medium) - V1 API
  /v1/assessment_tags/{id}:
    put:
      summary: Update the name of an assessment tag record
      description: Update the name of a tag. Only organization admins are able to update tags.
      tags:
      - Tags
      parameters:
      - name: id
        in: path
        description: ID of the assessment tag
        required: true
        schema:
          type: integer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: The new name of the tag
              required:
              - name
      responses:
        '200':
          description: The updated assessment tag record
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    format: int64
                  name:
                    type: string
                    description: custom assessment tag
                required:
                - id
                - name
        '400':
          description: Missing required request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
        '404':
          description: Requesting party is missing admin privileges or no tag corresponding to the given ID was found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
        '422':
          description: Tag update failed unexpectedly (an array of error messages is returned in the response)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
      security:
      - BearerAuth: []
      - BasicAuth: []
      - ApiKeyAuth: []
    delete:
      summary: Remove an assessment tag record
      description: Remove a tag. Only organization admins are able to delete tags.
      tags:
      - Tags
      parameters:
      - name: id
        in: path
        description: ID of the assessment tag
        required: true
        schema:
          type: integer
      responses:
        '204':
          description: Tag was successfully removed
        '404':
          description: Requesting party is missing admin privileges or no tag corresponding to the given ID was found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
        '422':
          description: Tag deletion failed unexpectedly
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
      security:
      - BearerAuth: []
      - BasicAuth: []
      - ApiKeyAuth: []
    servers:
    - url: https://api.synack.com
      description: Commercial - V1 API
    - url: https://api.synack.us
      description: FedRAMP (Medium) - V1 API
  /v1/{org_uid}/tags:
    get:
      x-mint:
        metadata:
          title: Get Tags for an Organization
      summary: Returns list of tags per org
      description: Get Tags by Organization
      operationId: getTags
      tags:
      - Tags
      parameters:
      - name: org_uid
        in: path
        description: Organization UID
        required: true
        schema:
          type: string
      - name: search
        in: query
        description: Search for tags
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: limit
        in: query
        description: Maximum number of tags results to be returned
        schema:
          type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Document'
        '400':
          description: bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Bearer token is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - bearerAuth: []
    servers:
    - url: https://client.synack.com/api/streaming
      description: Commercial
    - url: https://client.synack.us/api/streaming
      description: FedRAMP (Medium)
  /v1.0/organizations/{orgUid}/tags:
    parameters:
    - $ref: '#/components/parameters/OrganizationUIDPath_2'
    post:
      operationId: postTags
      tags:
      - Tags
      description: "Create new tags. \n409 Conflict is logged as warn if the name matches the name of a tag that already exists in a given org uid.\n"
      x-mint:
        metadata:
          title: Create Asset Tags
      requestBody:
        description: Tags to create.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NewTags'
      responses:
        '201':
          $ref: '#/components/responses/PaginatedTagsResponse'
        '400':
          $ref: '#/components/responses/400BadRequest_2'
        '401':
          $ref: '#/components/responses/401Unauthorized'
        '403':
          $ref: '#/components/responses/403Forbidden'
        '404':
          $ref: '#/components/responses/404NotFound'
        '413':
          $ref: '#/components/responses/413RequestEntityTooLarge_2'
        '422':
          $ref: '#/components/responses/422EntityNotProcessable'
        '500':
          $ref: '#/components/responses/500InternalServerError'
        '503':
          $ref: '#/components/responses/503ServiceUnavailable'
      security:
      - OAuth2:
        - tag_gw
        - tag_gr
        - tag_ow
        - tag_or
        - tag_lw
        - tag_lr
        - asset_gw
        - asset_gr
        - asset_boss_ow
        - asset_client_ow
        - asset_or
        - asset_boss_lw
        - asset_client_lw
        - asset_lr
    delete:
      operationId: deleteTags
      tags:
      - Tags
      description: 'Deletes tags.

        '
      x-mint:
        metadata:
          title: Delete Asset Tags
      requestBody:
        description: Tags to delete.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteTags'
      responses:
        '204':
          $ref: '#/components/responses/204NoContent'
        '400':
          $ref: '#/components/responses/400BadRequest_2'
        '401':
          $ref: '#/components/responses/401Unauthorized'
        '403':
          $ref: '#/components/responses/403Forbidden'
        '500':
          $ref: '#/components/responses/500InternalServerError'
        '503':
          $ref: '#/components/responses/503ServiceUnavailable'
      security:
      - OAuth2:
        - tag_gw
        - tag_ow
        - asset_gw
        - asset_boss_ow
        - asset_client_ow
    patch:
      operationId: patchTags
      tags:
      - Tags
      description: 'Attach/detach entities to/from org uids and/or tag uids.

        '
      x-mint:
        metadata:
          title: Attach/Detach Tags to Assets.
      requestBody:
        description: Tags to patch.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchTags'
      responses:
        '204':
          $ref: '#/components/responses/204NoContent'
        '400':
          $ref: '#/components/responses/400BadRequest_2'
        '401':
          $ref: '#/components/responses/401Unauthorized'
        '403':
          $ref: '#/components/responses/403Forbidden'
        '413':
          $ref: '#/components/responses/413RequestEntityTooLarge_2'
        '422':
          $ref: '#/components/responses/422EntityNotProcessable'
        '500':
          $ref: '#/components/responses/500InternalServerError'
        '503':
          $ref: '#/components/responses/503ServiceUnavailable'
      security:
      - OAuth2:
        - tag_gw
        - tag_gr
        - tag_ow
        - tag_or
        - tag_lw
        - tag_lr
        - asset_gw
        - asset_gr
        - asset_boss_ow
        - asset_client_ow
        - asset_or
        - asset_boss_lw
        - asset_client_lw
        - asset_lr
    servers:
    - url: https://client.synack.com/api/tagging
      description: Commercial
    - url: https://client.synack.us/api/tagging
      description: FedRAMP (Medium)
  /v1.0/organizations/{orgUid}/tags/{tagUid}:
    parameters:
    - $ref: '#/components/parameters/OrganizationUIDPath_2'
    - $ref: '#/components/parameters/TagUIDPath'
    put:
      operationId: putTags
      tags:
      - Tags
      description: 'Updates tag name by tag uid.

        '
      x-mint:
        metadata:
          title: Update Tag Name
      requestBody:
        description: Update tag's name
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateTag'
      responses:
        '204':
          $ref: '#/components/responses/204NoContent'
        '400':
          $ref: '#/components/responses/400BadRequest_2'
        '401':
          $ref: '#/components/responses/401Unauthorized'
        '403':
          $ref: '#/components/responses/403Forbidden'
        '404':
          $ref: '#/components/responses/404NotFound'
        '409':
          $ref: '#/components/responses/409Conflict'
        '412':
          $ref: '#/components/responses/412PreconditionFailed'
        '422':
          $ref: '#/components/responses/422EntityNotProcessable'
        '500':
          $ref: '#/components/responses/500InternalServerError'
        '503':
          $ref: '#/components/responses/503ServiceUnavailable'
      security:
      - OAuth2:
        - tag_gw
        - tag_ow
        - asset_gw
        - asset_boss_ow
        - asset_client_ow
    servers:
    - url: https://client.synack.com/api/tagging
      description: Commercial
    - url: https://client.synack.us/api/tagging
      description: FedRAMP (Medium)
components:
  schemas:
    SeedUID:
      type: string
      pattern: ^[0-9a-f]{24}
      description: Unique identifier for a seed.
    FailedValidation:
      type: object
      required:
      - message
      properties:
        property:
          type: string
          readOnly: true
        value:
          type: string
          readOnly: true
        message:
          type: string
          readOnly: true
    BatchTagsUpdate:
      type: object
      description: Tags to remove and add to seeds and seed group
      properties:
        seedGroupTagsToDelete:
          type: array
          description: Array of tags to delete from the seed group.
          items:
            $ref: '#/components/schemas/Tag'
        seedGroupTagsToAdd:
          type: array
          description: Array of tags to add to the seed group.
          items:
            $ref: '#/components/schemas/Tag'
        seedUids:
          type: array
          description: Array of seed uids to apply tag update to.
          items:
            $ref: '#/components/schemas/SeedUID'
        seedTagsToDelete:
          type: array
          description: Array of tags to delete from the supplied seeds.
          items:
            $ref: '#/components/schemas/Tag'
        seedTagsToAdd:
          type: array
          description: Array of tags to add to the supplied seeds.
          items:
            $ref: '#/components/schemas/Tag'
    Tag:
      type: string
      pattern: ^[-_0-9a-zA-Z]{1,16}
    IndexedFailedValidations:
      type: object
      properties:
        index:
          type: integer
          description: Zero-based index indicating the which item in request containing an array of items has failed validation.
          readOnly: true
        failedValidation:
          type: array
          description: Array of failed validation rules.
          readOnly: true
          items:
            $ref: '#/components/schemas/FailedValidation'
    ProblemDetails:
      type: object
      description: 'See [RFC 7807: Problem Details for HTTP APIs](https://tools.ietf.org/html/rfc7807)'
      properties:
        type:
          type: string
          readOnly: true
        title:
          type: string
          readOnly: true
        status:
          type: integer
          format: int32
          minimum: 100
          maximum: 511
          description: HTTP Status code.
          readOnly: true
        detail:
          type: string
          description: Message detailing the problem.
          readOnly: true
        instance:
          type: string
          description: generated problem instance number to correlate with logs
          readOnly: true
        failedValidation:
          type: array
          description: Array of failed validation rules.
          readOnly: true
          items:
            $ref: '#/components/schemas/FailedValidation'
        failedValidations:
          type: array
          description: Array of indexed failed validation rules.
          readOnly: true
          items:
            $ref: '#/components/schemas/IndexedFailedValidations'
        maxBatchSize:
          type: integer
          description: Maximum processable batch size.
          readOnly: true
        batchSize:
          type: integer
          description: Batch size sent when batch is too large.
          readOnly: true
    SeedGroupUID:
      type: string
      pattern: ^[0-9a-f]{12}
      description: Unique identifier for a seed group.
    OrganizationUID:
      type: string
      pattern: ^[-_0-9a-z]{1,50}
      description: Unique identifier for an organization.
    Tag_2:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        editable:
          type: boolean
        organization_profile_id:
          type: integer
    Relationship:
      type: object
      properties:
        data: {}
        links:
          $ref: '#/components/schemas/Links'
    Data:
      type: object
      properties:
        attributes: {}
        id:
          type: string
        links:
          $ref: '#/components/schemas/Links'
        meta: {}
        relationships:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/Relationship'
        type:
          $ref: '#/components/schemas/ResourceType'
    Links:
      type: object
      properties:
        next:
          type: string
        prev:
          type: string
    Error:
      type: object
      properties:
        detail:
          type: string
        id:
          type: string
        source:
          type: string
        status:
          type: integer
        title:
          type: string
    Document:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/Data'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/Error'
        included:
          type: array
          items: {}
        links:
          $ref: '#/components/schemas/Links'
        meta: {}
    ResourceType:
      type: string
      enum:
      - asset_list
      - assets_counts
      - asset_details
      - asset_whois
      - asset_ports
      - asset_providers
      - asset_seed_groups
      - health_check
      - org_asset_ports
      - org_asset_suspected_vulns
      - org_asset_vulns
      - org_asset_listings_tests_latest
      - top_vulnerable_ports
      - top_unique_ports
      - most_recently_added_assets
      - top_cisa_cves
      - top_vulnerable_ips
      - asset_gateways
      - tags
      - last_tested_counts
      - last_assets_scan
    EntityType:
      type: string
      enum:
      - asset
      - assessment
      - seed
      - seedGroup
      - exploitableVulnerability
      - suspectedVulnerability
      description: Entity type
    Entity:
      allOf:
      - type: object
        required:
        - uid
        - entityType
        properties:
          uid:
            $ref: '#/components/schemas/EntityUID'
          entityType:
            $ref: '#/components/schemas/EntityType'
    UpdateTag:
      type: object
      required:
      - name
      properties:
        name:
          $ref: '#/components/schemas/TagName'
    TagUIDs:
      type: array
      items:
        $ref: '#/components/schemas/TagUID'
    Tag_3:
      allOf:
      - type: object
        required:
        - uid
        - name
        - orgUid
        properties:
          uid:
            $ref: '#/components/schemas/TagUID'
          name:
            $ref: '#/components/schemas/TagName'
          orgUid:
            $ref: '#/components/schemas/OrgUID'
          entities:
            $ref: '#/components/schemas/Entities'
    Tags:
      type: array
      items:
        $ref: '#/components/schemas/Tag_3'
    DeleteTags:
      type: object
      required:
      - uids
      properties:
        uids:
          $ref: '#/components/schemas/TagUIDs'
    DelEntities:
      type: array
      items:
        $ref: '#/components/schemas/EntityUID'
    OrgUID:
      type: string
      pattern: ^[0-9a-z]{1,50}
      description: Unique identifier for an organization.
    PageOfTags:
      type: object
      properties:
        tags:
          $ref: '#/components/schemas/Tags'
    PatchTags:
      type: object
      required:
      - uids
      properties:
        uids:
          $ref: '#/components/schemas/TagUIDs'
        addEntities:
          $ref: '#/components/schemas/Entities'
        delEntityUids:
          $ref: '#/components/schemas/DelEntities'
    NewTag:
      allOf:
      - type: object
        required:
        - name
        properties:
          name:
            $ref: '#/components/schemas/TagName'
          entities:
            $ref: '#/components/schemas/Entities'
    TagName:
      type: string
      description: User-supplied name for this tag.
    EntityUID:
      type: string
      pattern: ^[0-9a-f]{12}
      description: Unique identifier for an entity.
    ErrorResponse:
      type: object
      description: Error response
      properties:
        id:
          type: string
          readOnly: true
          description: X-Request-Id
        error:
          type: string
          readOnly: true
          description: Message detailing the problem.
    Entities:
      type: array
      items:
        $ref: '#/components/schemas/Entity'
    TagUID:
      type: string
      pattern: ^[0-9a-f]{12}
      description: Unique identifier for a tag.
    NewTags:
      type: object
      properties:
        tags:
          type: array
          items:
            $ref: '#/components/schemas/NewTag'
  responses:
    401Unauthorized:
      description: Unauthorized.
    400BadRequest:
      description: Bad Request
    503ServiceUnavailable:
      description: Service Unavailable.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    413RequestEntityTooLarge:
      description: 'Returned generally when the size of the request body is too large to process, or specifically when the request contains too many items, typically in a bulk API operation.

        '
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    500InternalServerError:
      description: Internal Server Error.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    204NoContent:
      description: No content.
    403Forbidden:
      description: Forbidden
    409Conflict:
      description: Conflict.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    422EntityNotProcessable:
      description: Entity Not Processable
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    404NotFound:
      description: Not found.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    412PreconditionFailed:
      description: Precondition Failed.
    400BadRequest_2:
      description: Bad Request
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    413RequestEntityTooLarge_2:
      description: Returned generally when the size of the request body is too large to process, or specifically when the request contains too many items, typically in a bulk API operation.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    PaginatedTagsResponse:
      description: Paginated tags.
      headers:
        Pagination-Limit:
          $ref: '#/components/headers/PaginationLimit'
        Pagination-Current-Page:
          $ref: '#/components/headers/PaginationCurrentPage'
        Pagination-Total-Pages:
          $ref: '#/components/headers/PaginationTotalPages'
        Pagination-Total-Count:
          $ref: '#/components/headers/PaginationTotalCount'
        Link:
          $ref: '#/components/headers/Link'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PageOfTags'
  parameters:
    OrganizationUIDPath:
      name: organizationUid
      in: path
      schema:
        $ref: '#/components/schemas/OrganizationUID'
      required: true
      description: Unique identifier for an organization group.
    SeedGroupUIDPath:
      name: seedGroupUid
      in: path
      schema:
        $ref: '#/components/schemas/SeedGroupUID'
      required: true
      description: Unique identifier for a seed group.
    OrganizationUIDPath_2:
      name: orgUid
      in: path
      schema:
        $ref: '#/components/schemas/OrgUID'
      required: true
      description: Unique identifier for an organization group.
    TagUIDPath:
      name: tagUid
      in: path
      schema:
        $ref: '#/components/schemas/TagUID'
      required: true
      description: Unique identifier for a tag.
  headers:
    Link:
      description: Standard link header.
      schema:
        type: string
    PaginationTotalPages:
      description: Total number of pages in a paginated response.
      schema:
        type: integer
        format: int32
        minimum: 1
    PaginationTotalCount:
      description: Total number of items in all pages of a paginated response.
      schema:
        format: int32
        minimum: 1
    PaginationLimit:
      description: Maximum number of items returned in a paginated response.
      schema:
        type: integer
        format: int32
        minimum: 1
    PaginationCurrentPage:
      description: Current page in a paginated response.
      schema:
        type: 

# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/synack/refs/heads/main/openapi/synack-tags-api-openapi.yml