Progress Software Teams API

Teams are used to group local users for policy membership.

Documentation GitHub OpenAPI

Business capability

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /apis/iam/v2/teams List local teams · Lists all local teams #

Ask an LLM

“What local teams exist in Chef Automate?”

“Can I see all teams used in IAM policies?”

Tell an agent

List all local teams.

Show me every IAM team.

POST /apis/iam/v2/teams Create a local team · Creates a local team #

Ask an LLM

“How do I create a team to group users for IAM policies?”

“Can a new team be assigned to projects?”

Tell an agent

Create team {id} named {name}.

Create team {id} called {name} in projects {projects}.

GET /apis/iam/v2/teams/{id} Get a team · Get a team #

Ask an LLM

“What are the details of a specific team?”

“Which projects is a team assigned to?”

Tell an agent

Show team {id}.

Get details of team {id}.

PUT /apis/iam/v2/teams/{id} Update a local team · Updates a local team #

Ask an LLM

“How do I rename a team?”

“Can I change the projects a team belongs to?”

Tell an agent

Rename team {id} to {name}.

Set team {id}'s projects to {projects}.

DELETE /apis/iam/v2/teams/{id} Delete a local team · Deletes a local team #

Ask an LLM

“Does deleting a team remove it from policies?”

“How do I delete a team I no longer need?”

Tell an agent destructive · confirm first

Delete team {id}.

Remove team {id} and its policy memberships.

GET /apis/iam/v2/teams/{id}/users List a team's members · Gets local team membership #

Ask an LLM

“Who is on a particular team?”

“Are team members listed by membership ID?”

Tell an agent

List the members of team {id}.

Show which users belong to team {id}.

POST /apis/iam/v2/teams/{id}/users:add Add users to a team · Adds local team membership #

Ask an LLM

“How do I add users to a team?”

“Does adding team members check that the membership IDs are real users?”

Tell an agent

Add users {membership_ids} to team {id}.

Put membership IDs {membership_ids} on team {id}.

POST /apis/iam/v2/teams/{id}/users:remove Remove users from a team · Removes local team membership #

Ask an LLM

“How do I take users off a team?”

“Can I remove several members from a team at once?”

Tell an agent

Remove users {membership_ids} from team {id}.

Take membership IDs {membership_ids} off team {id}.

GET /apis/iam/v2/users/{membership_id}/teams List teams a user belongs to · Gets team membership for a user #

Ask an LLM

“Which teams is a given user on?”

“Can I find a user's teams using their membership ID?”

Tell an agent

List the teams for user {membership_id}.

Show which teams membership {membership_id} belongs to.

Documentation

📖

Documentation

https://docs.chef.io/automate/

📖

APIReference

https://docs.chef.io/automate/api/

📖

APIReference

https://docs.ipswitch.com/MOVEit/Transfer2025/Api/Rest/

📖

Documentation

https://docs.progress.com/category/moveit

📖

APIReference

https://docs.ipswitch.com/NM/WhatsUpGold2026/02_Guides/rest_api/index.html

📖

Documentation

https://www.whatsupgold.com/rest-api

Specifications

⚙

OpenAPI

https://artifacts.apis.io/progress-software/openapi/progress-software-teams-api-openapi.yml

Work with this as data

Every API 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 apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
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 API

curl "https://apis.io/api/v1/apis/progress-software:progress-software-teams-api"

All apis

curl "https://apis.io/api/v1/apis?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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  description: '# Authentication

    The Chef Automate API typically uses an API token passed in the header of your API request.'
  title: Chef Automate API Documentation Teams API
  termsOfService: https://www.chef.io/terms-and-conditions-of-use/
  contact:
    url: https://www.chef.io/support/
    email: support@chef.io
  license:
    name: Apache 2.0
    url: https://github.com/chef/automate/blob/main/LICENSE
  version: version not set
  x-logo:
    altText: Chef logo
    url: /images/chef-automate-logo.svg
servers:
- url: https://automate.chef.io
tags:
- description: Teams are used to group local users for policy membership.
  name: Teams
  x-displayName: IAM Teams
paths:
  /apis/iam/v2/teams:
    get:
      description: 'Lists all local teams.


        Authorization Action:

        ```

        iam:teams:list

        ```'
      tags:
      - Teams
      summary: Lists all local teams
      operationId: Teams_ListTeams
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.iam.v2.ListTeamsResp'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
    post:
      description: 'Creates a local team that is used to group local users as members of IAM policies.


        Authorization Action:

        ```

        iam:teams:create

        ```'
      tags:
      - Teams
      summary: Creates a local team
      operationId: Teams_CreateTeam
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.iam.v2.CreateTeamResp'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      x-code-samples:
      - lang: JSON
        source: '{"id": "test-id", "name": "My Test Team", "projects": ["project1", "project2"]}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/chef.automate.api.iam.v2.CreateTeamReq'
        required: true
  /apis/iam/v2/teams/{id}:
    get:
      description: 'Returns the details for a team.


        Authorization Action:

        ```

        iam:teams:get

        ```'
      tags:
      - Teams
      summary: Get a team
      operationId: Teams_GetTeam
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.iam.v2.GetTeamResp'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
    put:
      description: 'Updates a local team.


        Authorization Action:

        ```

        iam:teams:update

        ```'
      tags:
      - Teams
      summary: Updates a local team
      operationId: Teams_UpdateTeam
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.iam.v2.UpdateTeamResp'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      x-code-samples:
      - lang: JSON
        source: '{"name": "My Update Test Team", "projects": ["project1", "projectnew"]}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/chef.automate.api.iam.v2.UpdateTeamReq'
        required: true
    delete:
      description: 'Deletes a local team and removes it from any policies.


        Authorization Action:

        ```

        iam:teams:delete

        ```'
      tags:
      - Teams
      summary: Deletes a local team
      operationId: Teams_DeleteTeam
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.iam.v2.DeleteTeamResp'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
  /apis/iam/v2/teams/{id}/users:
    get:
      description: 'Lists all users of a local team. Users are listed by their membership_id.


        Authorization Action:

        ```

        iam:teamUsers:list

        ```'
      tags:
      - Teams
      summary: Gets local team membership
      operationId: Teams_GetTeamMembership
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.iam.v2.GetTeamMembershipResp'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
  /apis/iam/v2/teams/{id}/users:add:
    post:
      description: 'Adds a list of users to a local team. Users are added by their membership_id.

        The request currently does not validate that membership_id maps to a real user.


        The membership_id for users can be found via GET /apis/apis/iam/v2/users/.


        Authorization Action:

        ```

        iam:teamUsers:create

        ```'
      tags:
      - Teams
      summary: Adds local team membership
      operationId: Teams_AddTeamMembers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.iam.v2.AddTeamMembersResp'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      x-code-samples:
      - lang: JSON
        source: '{membership_ids: ["527ed96f-2ecb-4f8f-abd7-0bf6511459ac", "987c8475-5747-4f9b-a766-c337f73965ae"]}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/chef.automate.api.iam.v2.AddTeamMembersReq'
        required: true
  /apis/iam/v2/teams/{id}/users:remove:
    post:
      description: 'Removes a list of users from a local team. Users are removed by their membership_id.

        The request currently does not validate that membership_id maps to a real user.


        The membership_id for users can be found via GET /apis/apis/iam/v2/users/.


        Authorization Action:

        ```

        iam:teamUsers:delete

        ```'
      tags:
      - Teams
      summary: Removes local team membership
      operationId: Teams_RemoveTeamMembers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.iam.v2.RemoveTeamMembersResp'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      x-code-samples:
      - lang: JSON
        source: '{membership_ids: ["527ed96f-2ecb-4f8f-abd7-0bf6511459ac", "987c8475-5747-4f9b-a766-c337f73965ae"]}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/chef.automate.api.iam.v2.RemoveTeamMembersReq'
        required: true
  /apis/iam/v2/users/{membership_id}/teams:
    get:
      description: 'Lists all local teams for a specific user. You must use their membership_id in the request URL.


        Authorization Action:

        ```

        iam:userTeams:get

        ```'
      tags:
      - Teams
      summary: Gets team membership for a user
      operationId: Teams_GetTeamsForMember
      parameters:
      - name: membership_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.iam.v2.GetTeamsForMemberResp'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
components:
  schemas:
    chef.automate.api.iam.v2.DeleteTeamResp:
      type: object
      properties:
        team:
          $ref: '#/components/schemas/chef.automate.api.iam.v2.Team'
      example:
        team:
          id: test-id
          name: My Test Team
          projects:
          - project1
          - project2
    google.protobuf.Any:
      type: object
      properties:
        type_url:
          type: string
        value:
          type: string
          format: byte
    chef.automate.api.iam.v2.UpdateTeamResp:
      type: object
      properties:
        team:
          $ref: '#/components/schemas/chef.automate.api.iam.v2.Team'
      example:
        team:
          id: test-id
          name: My Test Team
          projects:
          - project1
          - project2
    chef.automate.api.iam.v2.RemoveTeamMembersResp:
      type: object
      properties:
        membership_ids:
          type: array
          items:
            type: string
      example:
        membership_ids:
        - 527ed96f-2ecb-4f8f-abd7-0bf6511459ac
        - 353a62d4-85fa-4423-b12a-f6608a562ae9
    chef.automate.api.iam.v2.ListTeamsResp:
      type: object
      properties:
        teams:
          type: array
          items:
            $ref: '#/components/schemas/chef.automate.api.iam.v2.Team'
      example:
        teams:
        - id: test-1
          name: My Test Team
          projects:
          - project1
          - project2
        - id: test-2
          name: My Test Team 2
          projects:
          - project1
    chef.automate.api.iam.v2.GetTeamsForMemberResp:
      type: object
      properties:
        teams:
          type: array
          items:
            $ref: '#/components/schemas/chef.automate.api.iam.v2.Team'
      example:
        teams:
        - id: test-1
          name: My Test Team
          projects:
          - project1
          - project2
        - id: test-2
          name: My Test Team 2
          projects:
          - project1
    chef.automate.api.iam.v2.CreateTeamReq:
      type: object
      required:
      - id
      - name
      properties:
        id:
          type: string
        name:
          type: string
        projects:
          type: array
          items:
            type: string
      example:
        id: my-team-id
        name: My Test Team
        projects:
        - project1
        - project2
    chef.automate.api.iam.v2.GetTeamMembershipResp:
      type: object
      properties:
        membership_ids:
          type: array
          items:
            type: string
      example:
        membership_ids:
        - 527ed96f-2ecb-4f8f-abd7-0bf6511459ac
        - 353a62d4-85fa-4423-b12a-f6608a562ae9
    chef.automate.api.iam.v2.AddTeamMembersResp:
      type: object
      properties:
        membership_ids:
          type: array
          items:
            type: string
      example:
        membership_ids:
        - 527ed96f-2ecb-4f8f-abd7-0bf6511459ac
        - 353a62d4-85fa-4423-b12a-f6608a562ae9
    chef.automate.api.iam.v2.UpdateTeamReq:
      type: object
      required:
      - id
      - name
      properties:
        id:
          type: string
        name:
          type: string
        projects:
          type: array
          items:
            type: string
      example:
        id: my-team-id
        name: My Test Team
        projects:
        - project1
        - project2
    chef.automate.api.iam.v2.RemoveTeamMembersReq:
      type: object
      required:
      - id
      - membership_ids
      properties:
        id:
          type: string
        membership_ids:
          type: array
          items:
            type: string
      example:
        id: admins
        membership_ids:
        - 527ed96f-2ecb-4f8f-abd7-0bf6511459ac
        - 353a62d4-85fa-4423-b12a-f6608a562ae9
    chef.automate.api.iam.v2.AddTeamMembersReq:
      type: object
      required:
      - id
      - membership_ids
      properties:
        id:
          type: string
        membership_ids:
          type: array
          items:
            type: string
      example:
        id: admins
        membership_ids:
        - 527ed96f-2ecb-4f8f-abd7-0bf6511459ac
        - 353a62d4-85fa-4423-b12a-f6608a562ae9
    chef.automate.api.iam.v2.GetTeamResp:
      type: object
      properties:
        team:
          $ref: '#/components/schemas/chef.automate.api.iam.v2.Team'
      example:
        team:
          id: test-id
          name: My Test Team
          projects:
          - project1
          - project2
    chef.automate.api.iam.v2.CreateTeamResp:
      type: object
      properties:
        team:
          $ref: '#/components/schemas/chef.automate.api.iam.v2.Team'
      example:
        team:
          id: test-id
          name: My Test Team
          projects:
          - project1
          - project2
    chef.automate.api.iam.v2.Team:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        projects:
          type: array
          items:
            type: string
    grpc.gateway.runtime.Error:
      type: object
      properties:
        code:
          type: integer
          format: int32
        details:
          type: array
          items:
            $ref: '#/components/schemas/google.protobuf.Any'
        error:
          type: string
        message:
          type: string
  securitySchemes:
    APIToken:
      description: Authenticate with the Automate API using an API Token.
      type: apiKey
      name: api-token
      in: header
x-tagGroups:
- name: Compliance
  tags:
  - ReportingService
  - StatsService
  - JobsService
  - ProfilesService
  - Comp_Assets
- name: Report Manager
  tags:
  - ReportManagerService
- name: Infra
  tags:
  - ConfigMgmt
  - InfraProxy
- name: Ingest
  tags:
  - ChefIngester
  - JobScheduler
- name: Node Management
  tags:
  - NodeManagerService
  - NodesService
- name: Event Feed
  tags:
  - EventFeedService
- name: Secrets
  tags:
  - SecretsService
- name: Applications
  tags:
  - service_groups
  - retention
  - ApplicationsService
- name: Data Feed
  tags:
  - DatafeedService
- name: Data Lifecycle
  tags:
  - DataLifecycle
- name: Notifications
  tags:
  - Notifications
- name: Content Delivery
  tags:
  - Cds
- name: Audit and Settings
  tags:
  - UserSettingsService
- name: System
  tags:
  - Gateway
  - Deployment
  - License
  - Telemetry
  - LegacyDataCollector
- name: Identity
  tags:
  - users
  - teams
  - tokens
- name: Access Management
  tags:
  - policies
  - roles
  - projects
  - rules
  - Authorization