Adobe Suite · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for Adobe Workfront Team API
11 actions
11 updates
phrasing
extends
openapi/adobe-suite-team-api-openapi.yml
Generated by API Evangelist
Written by API Evangelist tooling for Adobe Suite's API. It is a proposal applied on top of the contract, not a document Adobe Suite publishes.
What the actions change
x-apievangelist-phrasing
Targets 11
$.info
$.paths['/team/{id}'].get
$.paths['/team/{id}'].put
$.paths['/team/{id}'].delete
$.paths['/team'].get
$.paths['/team'].put
$.paths['/team'].post
$.paths['/team'].delete
$.paths['/team/count'].get
$.paths['/team/search'].get
$.paths['/team/report'].get
OpenAPI Overlay
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Adobe Workfront Team API
version: 1.0.0
extends: openapi/adobe-suite-team-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-09-26'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 10
- target: $.paths['/team/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get a Workfront team
effect: read
questions:
- Who is on a particular team in Workfront?
- Can I fetch only selected fields of one team?
instructions:
- text: Show team {id}.
slots:
id: path.id
- text: Get fields {fields} of team {id}.
slots:
fields: query.fields
id: path.id
method: generated
generated: '2026-09-26'
- target: $.paths['/team/{id}'].put
update:
x-apievangelist-phrasing:
intent: Edit a Workfront team
effect: write
questions:
- How do I update the details of one team?
- Can I change a single team and get its updated fields back?
instructions:
- text: Edit team {id}.
slots:
id: path.id
- text: Update team {id} and return {fields}.
slots:
id: path.id
fields: query.fields
method: generated
generated: '2026-09-26'
- target: $.paths['/team/{id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a Workfront team
effect: destructive
questions:
- How do I delete one team from Workfront?
- Can I force-delete a team that still has references?
instructions:
- text: Delete team {id}.
slots:
id: path.id
- text: Force-delete team {id} with force {force}.
slots:
id: path.id
force: query.force
method: generated
generated: '2026-09-26'
- target: $.paths['/team'].get
update:
x-apievangelist-phrasing:
intent: Get several teams by ID
effect: read
questions:
- Can I load a batch of teams at once when I already know their IDs?
- What's the way to fetch multiple Workfront teams in one request?
instructions:
- text: Get teams {id}.
slots:
id: query.id
- text: Fetch fields {fields} for teams with IDs {id}.
slots:
fields: query.fields
id: query.id
method: generated
generated: '2026-09-26'
- target: $.paths['/team'].put
update:
x-apievangelist-phrasing:
intent: Bulk edit teams
effect: write
questions:
- Can I update many teams in a single call?
- Is there a bulk edit for Workfront teams?
instructions:
- text: Bulk edit several teams in one request.
- text: Apply changes to multiple teams and return {fields}.
slots:
fields: query.fields
method: generated
generated: '2026-09-26'
- target: $.paths['/team'].post
update:
x-apievangelist-phrasing:
intent: Create a Workfront team
effect: write
questions:
- How do I create a new team in Workfront?
- Can I create a team and pick which fields come back?
instructions:
- text: Create a new team.
- text: Add a team and return fields {fields}.
slots:
fields: query.fields
method: generated
generated: '2026-09-26'
- target: $.paths['/team'].delete
update:
x-apievangelist-phrasing:
intent: Bulk delete teams
effect: destructive
questions:
- Can I delete a group of teams at once?
- What does force do when bulk deleting teams?
instructions:
- text: Delete teams {id}.
slots:
id: query.id
- text: Bulk delete teams {id} with force {force}.
slots:
id: query.id
force: query.force
method: generated
generated: '2026-09-26'
- target: $.paths['/team/count'].get
update:
x-apievangelist-phrasing:
intent: Count Workfront teams
effect: read
questions:
- How many teams do we have in Workfront?
- Can I count only teams matching certain conditions?
instructions:
- text: Count all teams.
- text: Count teams matching {filters}.
slots:
filters: query.filters
method: generated
generated: '2026-09-26'
- target: $.paths['/team/search'].get
update:
x-apievangelist-phrasing:
intent: Search Workfront teams
effect: read
questions:
- Which teams match a given set of filter conditions?
- Can I search teams by name and page the results?
instructions:
- text: Search teams where {filters}.
slots:
filters: query.filters
- text: Find teams matching {filters} with list options {listOptions}.
slots:
filters: query.filters
listOptions: query.listOptions
method: generated
generated: '2026-09-26'
- target: $.paths['/team/report'].get
update:
x-apievangelist-phrasing:
intent: Run a report on teams
effect: read
questions:
- Can I get an aggregated report across our teams?
- What does a grouped report of Workfront teams return?
instructions:
- text: Run a team report for {filters}.
slots:
filters: query.filters
- text: Build a report over teams using options {listOptions}.
slots:
listOptions: query.listOptions
method: generated
generated: '2026-09-26'