Postman collectionAccessKeys API

The collectionAccessKeys API from Postman — 2 operation(s) for collectionaccesskeys.

Operations 2

GET /collection-access-keys Get collection access keys #
DELETE /collection-access-keys/{keyId} Delete a collection access key #

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/postman-collectionaccesskeys-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

OpenAPI Specification

postman-collectionaccesskeys-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Postman Collection Access Keys API
  version: 1.0.0
servers:
- url: https://api.postman.com
  description: https://api.postman.com
- url: https://api.eu.postman.com
  description: https://api.eu.postman.com
tags:
- name: collectionAccessKeys
paths:
  /collection-access-keys:
    get:
      operationId: getCollectionAccessKeys
      summary: Get collection access keys
      description: 'Gets the authenticated user''s personal and team [collection access keys](https://learning.postman.com/docs/developer/postman-api/authentication/#generate-a-collection-access-key).


        **Note:**


        - The `expiresAfter` property in the response represents the date and time at which the access key expires. Collection access keys are valid for 60 days. If unused, the access key expires after 60 days. If someone uses the access key, then its expiration date increases by another 60 days.

        - If the collection key is unused, the `lastUsedAt` property in the response returns an empty string.

        '
      tags:
      - collectionAccessKeys
      parameters:
      - name: collectionId
        in: query
        description: Filter the results by a collection's unique ID.
        required: false
        schema:
          $ref: '#/components/schemas/collectionUidQuery'
      - name: cursor
        in: query
        description: The pointer to the first record of the set of paginated results. To view the next response, use the `nextCursor` value for this parameter.
        required: false
        schema:
          $ref: '#/components/schemas/cursor'
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/getCollectionAccessKeys'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCollectionAccessKeysRequestBadRequestError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCollectionAccessKeysRequestUnauthorizedError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCollectionAccessKeysRequestForbiddenError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCollectionAccessKeysRequestInternalServerError'
  /collection-access-keys/{keyId}:
    delete:
      operationId: deleteCollectionAccessKey
      summary: Delete a collection access key
      description: 'Deletes a collection access key. To get a collection access key''s ID, use the GET `/collection-access-key` endpoint.


        On success, this returns an HTTP `204 No Content` response.

        '
      tags:
      - collectionAccessKeys
      parameters:
      - name: keyId
        in: path
        description: The collection access key's ID.
        required: true
        schema:
          $ref: '#/components/schemas/collectionAccessKeyId'
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
          content:
            application/json:
              schema:
                type: object
                properties: {}
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteCollectionAccessKeyRequestUnauthorizedError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteCollectionAccessKeyRequestForbiddenError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common404Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteCollectionAccessKeyRequestInternalServerError'
components:
  schemas:
    DeleteCollectionAccessKeyRequestUnauthorizedError:
      oneOf:
      - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus'
      - $ref: '#/components/schemas/commonErrorNameMessage'
      title: DeleteCollectionAccessKeyRequestUnauthorizedError
    collectionUidQuery:
      type: string
      format: uid
      title: collectionUidQuery
    CommonErrorNameMessageError:
      type: object
      properties:
        name:
          type: string
          description: The error name.
        message:
          type: string
          description: The error message.
      description: Information about the error.
      title: CommonErrorNameMessageError
    commonErrorTypeTitleDetail:
      type: object
      properties:
        type:
          type: string
          description: The type of error.
        title:
          type: string
          description: A short summary of the problem.
        detail:
          $ref: '#/components/schemas/CommonErrorTypeTitleDetailDetail'
          description: Information about the error.
      title: commonErrorTypeTitleDetail
    DeleteCollectionAccessKeyRequestForbiddenError:
      oneOf:
      - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus'
      - $ref: '#/components/schemas/commonErrorNameMessage'
      title: DeleteCollectionAccessKeyRequestForbiddenError
    DeleteCollectionAccessKeyRequestInternalServerError:
      oneOf:
      - $ref: '#/components/schemas/commonErrorTypeTitleDetail'
      - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus'
      - $ref: '#/components/schemas/commonErrorNameMessage'
      title: DeleteCollectionAccessKeyRequestInternalServerError
    GetCollectionAccessKeysRequestUnauthorizedError:
      oneOf:
      - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus'
      - $ref: '#/components/schemas/commonErrorNameMessage'
      title: GetCollectionAccessKeysRequestUnauthorizedError
    GetCollectionAccessKeysRequestForbiddenError:
      oneOf:
      - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus'
      - $ref: '#/components/schemas/commonErrorNameMessage'
      title: GetCollectionAccessKeysRequestForbiddenError
    commonErrorTypeTitleDetailStatus:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/CommonErrorTypeTitleDetailStatusType'
        title:
          type: string
          description: A short summary of the problem.
        detail:
          type: string
          description: Information about the error.
        status:
          type: integer
          description: The error's HTTP status code.
      title: commonErrorTypeTitleDetailStatus
    CommonErrorTypeTitleDetailDetail:
      oneOf:
      - type: string
      - type: object
        additionalProperties:
          description: Any type
      description: Information about the error.
      title: CommonErrorTypeTitleDetailDetail
    common404Error:
      type: object
      properties:
        type:
          type: string
          format: uri-reference
          description: The [URI reference](https://www.rfc-editor.org/rfc/rfc3986) that identifies the type of problem.
        title:
          type: string
          description: A short summary of the problem.
        status:
          type: integer
          description: The HTTP status code generated by the origin server.
        detail:
          type: string
          description: An explanation about the problem.
      title: common404Error
    GetCollectionAccessKeysMeta:
      type: object
      properties:
        nextCursor:
          type: string
          description: The pagination cursor that points to the next record in the results set.
        prevCursor:
          type: string
          description: The pagination cursor to previous set of response data.
      description: The response's non-standard metadata information.
      title: GetCollectionAccessKeysMeta
    getCollectionAccessKeys:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/GetCollectionAccessKeysDataItems'
          description: A list of collection access keys.
        meta:
          $ref: '#/components/schemas/GetCollectionAccessKeysMeta'
          description: The response's non-standard metadata information.
      title: getCollectionAccessKeys
    commonErrorNameMessageDetails:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/CommonErrorNameMessageDetailsError'
      title: commonErrorNameMessageDetails
    CommonErrorNameMessageDetailsErrorDetails:
      oneOf:
      - type: object
        additionalProperties:
          description: Any type
      - type: array
        items:
          type: string
      description: Information about the error.
      title: CommonErrorNameMessageDetailsErrorDetails
    cursor:
      type: string
      title: cursor
    commonErrorNameMessage:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/CommonErrorNameMessageError'
          description: Information about the error.
      title: commonErrorNameMessage
    collectionAccessKeyId:
      type: string
      title: collectionAccessKeyId
    CommonErrorTypeTitleDetailStatusType:
      oneOf:
      - type: string
        format: uri-reference
      - type: string
      title: CommonErrorTypeTitleDetailStatusType
    GetCollectionAccessKeysDataItems:
      type: object
      properties:
        id:
          type: string
          description: The collection access key's ID.
        token:
          type: string
          description: The masked collection access key.
        status:
          $ref: '#/components/schemas/GetCollectionAccessKeysDataItemsStatus'
          description: The token's active status.
        teamId:
          type: integer
          description: The team ID of the collection access key's owner.
        userId:
          type: integer
          description: The user ID of the collection access key's owner.
        collectionId:
          type: string
          format: uid
          description: The collection access key's associated collection ID.
        expiresAfter:
          type: string
          format: date-time
          description: The date and time at which the collection access key expires. Collection access keys are valid for 60 days. If unused, the access key expires after 60 days. If someone uses the access key, then its expiration date increases by another 60 days.
        lastUsedAt:
          type: string
          description: The date and time at which the collection access key was used. If the collection key is unused, this returns an empty string value.
        createdAt:
          type: string
          format: date-time
          description: The date and time at which the collection access key was created.
        updatedAt:
          type: string
          format: date-time
          description: The date and time at which the collection access key was updated.
        deletedAt:
          type:
          - string
          - 'null'
          format: date-time
          description: The date and time at which the collection access key was revoked.
      description: Information about the collection access key.
      title: GetCollectionAccessKeysDataItems
    CommonErrorNameMessageDetailsError:
      type: object
      properties:
        name:
          type: string
          description: The error name.
        message:
          type: string
          description: The error message.
        details:
          $ref: '#/components/schemas/CommonErrorNameMessageDetailsErrorDetails'
          description: Information about the error.
      title: CommonErrorNameMessageDetailsError
    GetCollectionAccessKeysRequestInternalServerError:
      oneOf:
      - $ref: '#/components/schemas/commonErrorTypeTitleDetail'
      - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus'
      - $ref: '#/components/schemas/commonErrorNameMessage'
      title: GetCollectionAccessKeysRequestInternalServerError
    GetCollectionAccessKeysDataItemsStatus:
      type: string
      enum:
      - ACTIVE
      - INACTIVE
      description: The token's active status.
      title: GetCollectionAccessKeysDataItemsStatus
    GetCollectionAccessKeysRequestBadRequestError:
      oneOf:
      - $ref: '#/components/schemas/commonErrorTypeTitleDetail'
      - $ref: '#/components/schemas/commonErrorTypeTitleDetailStatus'
      - $ref: '#/components/schemas/commonErrorNameMessageDetails'
      title: GetCollectionAccessKeysRequestBadRequestError
  securitySchemes:
    PostmanApiKey:
      type: apiKey
      in: header
      name: x-api-key
    basicAuth:
      type: http
      scheme: basic
    scimApiKey:
      type: apiKey
      in: header
      name: Authorization
      description: A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.
x-provenance:
  first_party: true
  method: harvested
  provider_published: true
  source: https://learning.postman.com/api-docs/openapi.json
  harvested: '2026-08-05'
  note: Postman's own OpenAPI 3.1 definition for the Postman API, served by its Fern-hosted API reference. 162 paths, 256 operations, servers api.postman.com and api.eu.postman.com.