Tricentis · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for qTest Manager API Version 3.0 Field API

19 actions 19 updates phrasing extends openapi/tricentis-field-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Tricentis's API. It is a proposal applied on top of the contract, not a document Tricentis publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 19 · first 16 shown; the file carries all of them

$.info
$.paths['/api/v3/fields/{objectType}'].get
$.paths['/api/v3/fields/{objectType}'].post
$.paths['/api/v3/fields/{objectType}/{fieldId}'].get
$.paths['/api/v3/fields/{objectType}/{fieldId}'].put
$.paths['/api/v3/fields/{objectType}/{fieldId}'].delete
$.paths['/api/v3/fields/{objectType}/{fieldId}/allowed-values'].get
$.paths['/api/v3/fields/{objectType}/{fieldId}/allowed-values'].post
$.paths['/api/v3/fields/{objectType}/{fieldId}/allowed-values/{value}'].put
$.paths['/api/v3/fields/{objectType}/{fieldId}/allowed-values/{value}'].delete
$.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields'].get
$.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields'].post
$.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}'].get
$.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}'].put
$.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}'].delete
$.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}/allowed-values'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for qTest Manager API Version 3.0 Field API
  version: 1.0.0
extends: openapi/tricentis-field-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 18
- target: $.paths['/api/v3/fields/{objectType}'].get
  update:
    x-apievangelist-phrasing:
      intent: List site-level fields of an object type
      effect: read
      questions:
      - What site-wide fields exist for test cases across all projects?
      - Can I page through the site-level fields defined for defects?
      instructions:
      - text: List the site-level fields for {type}.
        slots:
          type: path.objectType
      - text: Show page {page} of site fields for object type {type}.
        slots:
          type: path.objectType
          page: query.page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/fields/{objectType}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a site-level custom field
      effect: write
      questions:
      - How do I add a custom field that applies at the site level for every project?
      - Can a new site field be required and searchable?
      instructions:
      - text: Create a site-level custom field labelled {label} on {type}.
        slots:
          type: path.objectType
          label: requestBody.label
      - text: Add a required site field {label} of data type {data_type} for {type}.
        slots:
          type: path.objectType
          label: requestBody.label
          data_type: requestBody.data_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/fields/{objectType}/{fieldId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a site-level custom field
      effect: read
      questions:
      - How can I look up one site-level custom field's settings?
      - What data type and default value does a given site field have?
      instructions:
      - text: Get site field {field} of {type}.
        slots:
          type: path.objectType
          field: path.fieldId
      - text: Show the settings of site-level custom field {field} on {type}.
        slots:
          type: path.objectType
          field: path.fieldId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/fields/{objectType}/{fieldId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a site-level custom field
      effect: write
      questions:
      - Can I rename or deactivate a site-wide custom field?
      - How do I make an existing site field required for everyone?
      instructions:
      - text: Rename site field {field} on {type} to {label}.
        slots:
          type: path.objectType
          field: path.fieldId
          label: requestBody.label
      - text: Deactivate the site-level custom field {field} of {type}.
        slots:
          type: path.objectType
          field: path.fieldId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/fields/{objectType}/{fieldId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a site-level custom field
      effect: destructive
      questions:
      - Can I delete a custom field defined at the site level?
      - What's the way to remove an unused site-wide field from requirements?
      instructions:
      - text: Delete site field {field} from {type}.
        slots:
          type: path.objectType
          field: path.fieldId
      - text: Remove the site-level custom field {field} on {type} permanently.
        slots:
          type: path.objectType
          field: path.fieldId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/fields/{objectType}/{fieldId}/allowed-values'].get
  update:
    x-apievangelist-phrasing:
      intent: List allowed values of a site field
      effect: read
      questions:
      - Which options can be picked in a site-level combo box field?
      - Can I list the allowed values of a site-wide user list field?
      instructions:
      - text: List the allowed values of site field {field} on {type}.
        slots:
          type: path.objectType
          field: path.fieldId
      - text: Show page {page} of options for site-level field {field} of {type}.
        slots:
          type: path.objectType
          field: path.fieldId
          page: query.page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/fields/{objectType}/{fieldId}/allowed-values'].post
  update:
    x-apievangelist-phrasing:
      intent: Add allowed values to a site field
      effect: write
      questions:
      - How many new options can I add to a site-level dropdown field at once?
      - Can I add choices to a site-wide check box field?
      instructions:
      - text: Add allowed values to site field {field} on {type}.
        slots:
          type: path.objectType
          field: path.fieldId
      - text: Create new dropdown options for the site-level field {field} of {type}.
        slots:
          type: path.objectType
          field: path.fieldId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/fields/{objectType}/{fieldId}/allowed-values/{value}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an allowed value of a site field
      effect: write
      questions:
      - Can I change the label or color of one option in a site-level field?
      - How do I make a site field option the default?
      instructions:
      - text: Update option {value} of site field {field} on {type}.
        slots:
          type: path.objectType
          field: path.fieldId
          value: path.value
      - text: Relabel allowed value {value} of site-level field {field} ({type}) to {label}.
        slots:
          type: path.objectType
          field: path.fieldId
          value: path.value
          label: requestBody.label
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/fields/{objectType}/{fieldId}/allowed-values/{value}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an allowed value of a site field
      effect: destructive
      questions:
      - Can I remove an outdated choice from a site-level combo box?
      - What's involved in deleting one option of a site-wide field?
      instructions:
      - text: Delete allowed value {value} from site field {field} on {type}.
        slots:
          type: path.objectType
          field: path.fieldId
          value: path.value
      - text: Remove option {value} of the site-level field {field} for {type}.
        slots:
          type: path.objectType
          field: path.fieldId
          value: path.value
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields'].get
  update:
    x-apievangelist-phrasing:
      intent: List a project's fields for an object type
      effect: read
      questions:
      - Which fields does my project use for test runs, including inactive ones?
      - What fields are configured on requirements in a specific project?
      instructions:
      - text: List the fields of {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
      - text: Show all {type} fields in project {project}, including inactive ones.
        slots:
          project: path.projectId
          type: path.objectType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a project custom field
      effect: write
      questions:
      - How do I add a custom field to test cases in just one project?
      - Can a project-level custom field have allowed values and a default?
      instructions:
      - text: Create a custom field labelled {label} on {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          label: requestBody.label
      - text: Add a project field {label} with data type {data_type} to {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          label: requestBody.label
          data_type: requestBody.data_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a project custom field
      effect: read
      questions:
      - How can I read one project-level custom field's configuration?
      - Is a particular project field required or searchable?
      instructions:
      - text: Get field {field} of {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
      - text: Show the configuration of project custom field {field} on {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a project custom field
      effect: write
      questions:
      - Can I change the label of a custom field in one project?
      - How do I mark a project-level field inactive?
      instructions:
      - text: Rename field {field} on {type} in project {project} to {label}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
          label: requestBody.label
      - text: Make project custom field {field} of {type} in project {project} required.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a project custom field
      effect: destructive
      questions:
      - Can I delete a custom field from a single project?
      - Which project-level fields can be removed from defects?
      instructions:
      - text: Delete field {field} from {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
      - text: Remove the project custom field {field} on {type} in project {project} permanently.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}/allowed-values'].get
  update:
    x-apievangelist-phrasing:
      intent: List allowed values of a project field
      effect: read
      questions:
      - What options are available in a project's custom dropdown field?
      - Can I page through the allowed values of a project-level user list field?
      instructions:
      - text: List the allowed values of field {field} on {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
      - text: Show page {page} of options for project field {field} ({type}) in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
          page: query.page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}/allowed-values'].post
  update:
    x-apievangelist-phrasing:
      intent: Add allowed values to a project field
      effect: write
      questions:
      - How can I add options to a combo box field in one project?
      - Is there a limit on how many values I can add to a project field at once?
      instructions:
      - text: Add allowed values to field {field} on {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
      - text: Create new options for project field {field} of {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}/allowed-values/{value}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an allowed value of a project field
      effect: write
      questions:
      - Can I recolor or reorder a single option of a project-level field?
      - How do I deactivate one choice in a project dropdown without deleting it?
      instructions:
      - text: Update option {value} of field {field} on {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
          value: path.value
      - text: Set the label of value {value} in project field {field} ({type}, project {project}) to {label}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
          value: path.value
          label: requestBody.label
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v3/projects/{projectId}/settings/{objectType}/fields/{fieldId}/allowed-values/{value}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an allowed value of a project field
      effect: destructive
      questions:
      - Can I delete one option from a project's check box field?
      - What's the way to drop an obsolete value from a project dropdown?
      instructions:
      - text: Delete allowed value {value} from field {field} on {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
          value: path.value
      - text: Remove option {value} of project field {field} for {type} in project {project}.
        slots:
          project: path.projectId
          type: path.objectType
          field: path.fieldId
          value: path.value
      method: generated
      generated: '2026-10-01'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/tricentis-field-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.