Prefect · Capability

Prefect Cloud API — Concurrency Limits

Prefect Cloud API — Concurrency Limits. 9 operations. Lead operation: Create Concurrency Limit. Self-contained Naftiko capability covering one Prefect business surface.

Run with Naftiko PrefectConcurrency Limits

What You Can Do

POST
Createconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitspost — Create Concurrency Limit
/v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits
POST
Decrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsdecrementpost — Decrement Concurrency Limits V1
/v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/decrement
POST
Readconcurrencylimitsapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsfilterpost — Read Concurrency Limits
/v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/filter
POST
Incrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsincrementpost — Increment Concurrency Limits V1
/v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/increment
GET
Readconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagget — Read Concurrency Limit By Tag
/v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/tag/{tag}
DELETE
Deleteconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagdelete — Delete Concurrency Limit By Tag
/v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/tag/{tag}
POST
Resetconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagresetpost — Reset Concurrency Limit By Tag
/v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/tag/{tag}/reset
GET
Readconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsidget — Read Concurrency Limit
/v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/{id}
DELETE
Deleteconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsiddelete — Delete Concurrency Limit
/v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/{id}

MCP Tools

create-concurrency-limit

Create Concurrency Limit

decrement-concurrency-limits-v1

Decrement Concurrency Limits V1

read-concurrency-limits

Read Concurrency Limits

increment-concurrency-limits-v1

Increment Concurrency Limits V1

read-concurrency-limit-tag

Read Concurrency Limit By Tag

read-only idempotent
delete-concurrency-limit-tag

Delete Concurrency Limit By Tag

idempotent
reset-concurrency-limit-tag

Reset Concurrency Limit By Tag

read-concurrency-limit

Read Concurrency Limit

read-only idempotent
delete-concurrency-limit

Delete Concurrency Limit

idempotent

Capability Spec

prefect-concurrency-limits.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: Prefect Cloud API — Concurrency Limits
  description: 'Prefect Cloud API — Concurrency Limits. 9 operations. Lead operation: Create Concurrency Limit. Self-contained
    Naftiko capability covering one Prefect business surface.'
  tags:
  - Prefect
  - Concurrency Limits
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PREFECT_API_KEY: PREFECT_API_KEY
capability:
  consumes:
  - type: http
    namespace: prefect-concurrency-limits
    baseUri: ''
    description: Prefect Cloud API — Concurrency Limits business capability. Self-contained, no shared references.
    resources:
    - name: api-accounts-account_id-workspaces-workspace_id-concurrency_limits
      path: /api/accounts/{account_id}/workspaces/{workspace_id}/concurrency_limits/
      operations:
      - name: createconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitspost
        method: POST
        description: Create Concurrency Limit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: workspace_id
          in: path
          type: string
          required: true
        - name: x-prefect-api-version
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-accounts-account_id-workspaces-workspace_id-concurrency_limits-decrement
      path: /api/accounts/{account_id}/workspaces/{workspace_id}/concurrency_limits/decrement
      operations:
      - name: decrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsdecrementpost
        method: POST
        description: Decrement Concurrency Limits V1
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace_id
          in: path
          type: string
          required: true
        - name: account_id
          in: path
          type: string
          required: true
        - name: x-prefect-api-version
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-accounts-account_id-workspaces-workspace_id-concurrency_limits-filter
      path: /api/accounts/{account_id}/workspaces/{workspace_id}/concurrency_limits/filter
      operations:
      - name: readconcurrencylimitsapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsfilterpost
        method: POST
        description: Read Concurrency Limits
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: workspace_id
          in: path
          type: string
          required: true
        - name: x-prefect-api-version
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-accounts-account_id-workspaces-workspace_id-concurrency_limits-increment
      path: /api/accounts/{account_id}/workspaces/{workspace_id}/concurrency_limits/increment
      operations:
      - name: incrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsincrementpost
        method: POST
        description: Increment Concurrency Limits V1
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: workspace_id
          in: path
          type: string
          required: true
        - name: x-prefect-api-version
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-accounts-account_id-workspaces-workspace_id-concurrency_limits-tag-tag
      path: /api/accounts/{account_id}/workspaces/{workspace_id}/concurrency_limits/tag/{tag}
      operations:
      - name: readconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagget
        method: GET
        description: Read Concurrency Limit By Tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: tag
          in: path
          type: string
          description: The tag name
          required: true
        - name: account_id
          in: path
          type: string
          required: true
        - name: workspace_id
          in: path
          type: string
          required: true
        - name: x-prefect-api-version
          in: header
          type: string
      - name: deleteconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagdelete
        method: DELETE
        description: Delete Concurrency Limit By Tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: tag
          in: path
          type: string
          description: The tag name
          required: true
        - name: account_id
          in: path
          type: string
          required: true
        - name: workspace_id
          in: path
          type: string
          required: true
        - name: x-prefect-api-version
          in: header
          type: string
    - name: api-accounts-account_id-workspaces-workspace_id-concurrency_limits-tag-tag-reset
      path: /api/accounts/{account_id}/workspaces/{workspace_id}/concurrency_limits/tag/{tag}/reset
      operations:
      - name: resetconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagresetpost
        method: POST
        description: Reset Concurrency Limit By Tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: tag
          in: path
          type: string
          description: The tag name
          required: true
        - name: workspace_id
          in: path
          type: string
          required: true
        - name: account_id
          in: path
          type: string
          required: true
        - name: x-prefect-api-version
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-accounts-account_id-workspaces-workspace_id-concurrency_limits-id
      path: /api/accounts/{account_id}/workspaces/{workspace_id}/concurrency_limits/{id}
      operations:
      - name: readconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsidget
        method: GET
        description: Read Concurrency Limit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The concurrency limit id
          required: true
        - name: account_id
          in: path
          type: string
          required: true
        - name: workspace_id
          in: path
          type: string
          required: true
        - name: x-prefect-api-version
          in: header
          type: string
      - name: deleteconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsiddelete
        method: DELETE
        description: Delete Concurrency Limit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The concurrency limit id
          required: true
        - name: account_id
          in: path
          type: string
          required: true
        - name: workspace_id
          in: path
          type: string
          required: true
        - name: x-prefect-api-version
          in: header
          type: string
  exposes:
  - type: rest
    namespace: prefect-concurrency-limits-rest
    port: 8080
    description: REST adapter for Prefect Cloud API — Concurrency Limits. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits
      name: api-accounts-account-id-workspaces-workspace-id-concurrency-limits
      description: REST surface for api-accounts-account_id-workspaces-workspace_id-concurrency_limits.
      operations:
      - method: POST
        name: createconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitspost
        description: Create Concurrency Limit
        call: prefect-concurrency-limits.createconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitspost
        with:
          account_id: rest.account_id
          workspace_id: rest.workspace_id
          x-prefect-api-version: rest.x-prefect-api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/decrement
      name: api-accounts-account-id-workspaces-workspace-id-concurrency-limits-decrement
      description: REST surface for api-accounts-account_id-workspaces-workspace_id-concurrency_limits-decrement.
      operations:
      - method: POST
        name: decrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsdecrementpost
        description: Decrement Concurrency Limits V1
        call: prefect-concurrency-limits.decrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsdecrementpost
        with:
          workspace_id: rest.workspace_id
          account_id: rest.account_id
          x-prefect-api-version: rest.x-prefect-api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/filter
      name: api-accounts-account-id-workspaces-workspace-id-concurrency-limits-filter
      description: REST surface for api-accounts-account_id-workspaces-workspace_id-concurrency_limits-filter.
      operations:
      - method: POST
        name: readconcurrencylimitsapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsfilterpost
        description: Read Concurrency Limits
        call: prefect-concurrency-limits.readconcurrencylimitsapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsfilterpost
        with:
          account_id: rest.account_id
          workspace_id: rest.workspace_id
          x-prefect-api-version: rest.x-prefect-api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/increment
      name: api-accounts-account-id-workspaces-workspace-id-concurrency-limits-increment
      description: REST surface for api-accounts-account_id-workspaces-workspace_id-concurrency_limits-increment.
      operations:
      - method: POST
        name: incrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsincrementpost
        description: Increment Concurrency Limits V1
        call: prefect-concurrency-limits.incrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsincrementpost
        with:
          account_id: rest.account_id
          workspace_id: rest.workspace_id
          x-prefect-api-version: rest.x-prefect-api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/tag/{tag}
      name: api-accounts-account-id-workspaces-workspace-id-concurrency-limits-tag-tag
      description: REST surface for api-accounts-account_id-workspaces-workspace_id-concurrency_limits-tag-tag.
      operations:
      - method: GET
        name: readconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagget
        description: Read Concurrency Limit By Tag
        call: prefect-concurrency-limits.readconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagget
        with:
          tag: rest.tag
          account_id: rest.account_id
          workspace_id: rest.workspace_id
          x-prefect-api-version: rest.x-prefect-api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagdelete
        description: Delete Concurrency Limit By Tag
        call: prefect-concurrency-limits.deleteconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagdelete
        with:
          tag: rest.tag
          account_id: rest.account_id
          workspace_id: rest.workspace_id
          x-prefect-api-version: rest.x-prefect-api-version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/tag/{tag}/reset
      name: api-accounts-account-id-workspaces-workspace-id-concurrency-limits-tag-tag-reset
      description: REST surface for api-accounts-account_id-workspaces-workspace_id-concurrency_limits-tag-tag-reset.
      operations:
      - method: POST
        name: resetconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagresetpost
        description: Reset Concurrency Limit By Tag
        call: prefect-concurrency-limits.resetconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagresetpost
        with:
          tag: rest.tag
          workspace_id: rest.workspace_id
          account_id: rest.account_id
          x-prefect-api-version: rest.x-prefect-api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/accounts/{account-id}/workspaces/{workspace-id}/concurrency-limits/{id}
      name: api-accounts-account-id-workspaces-workspace-id-concurrency-limits-id
      description: REST surface for api-accounts-account_id-workspaces-workspace_id-concurrency_limits-id.
      operations:
      - method: GET
        name: readconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsidget
        description: Read Concurrency Limit
        call: prefect-concurrency-limits.readconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsidget
        with:
          id: rest.id
          account_id: rest.account_id
          workspace_id: rest.workspace_id
          x-prefect-api-version: rest.x-prefect-api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsiddelete
        description: Delete Concurrency Limit
        call: prefect-concurrency-limits.deleteconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsiddelete
        with:
          id: rest.id
          account_id: rest.account_id
          workspace_id: rest.workspace_id
          x-prefect-api-version: rest.x-prefect-api-version
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: prefect-concurrency-limits-mcp
    port: 9090
    transport: http
    description: MCP adapter for Prefect Cloud API — Concurrency Limits. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: create-concurrency-limit
      description: Create Concurrency Limit
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: prefect-concurrency-limits.createconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitspost
      with:
        account_id: tools.account_id
        workspace_id: tools.workspace_id
        x-prefect-api-version: tools.x-prefect-api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: decrement-concurrency-limits-v1
      description: Decrement Concurrency Limits V1
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: prefect-concurrency-limits.decrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsdecrementpost
      with:
        workspace_id: tools.workspace_id
        account_id: tools.account_id
        x-prefect-api-version: tools.x-prefect-api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-concurrency-limits
      description: Read Concurrency Limits
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: prefect-concurrency-limits.readconcurrencylimitsapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsfilterpost
      with:
        account_id: tools.account_id
        workspace_id: tools.workspace_id
        x-prefect-api-version: tools.x-prefect-api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: increment-concurrency-limits-v1
      description: Increment Concurrency Limits V1
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: prefect-concurrency-limits.incrementconcurrencylimitsv1apiaccountsaccountidworkspacesworkspaceidconcurrencylimitsincrementpost
      with:
        account_id: tools.account_id
        workspace_id: tools.workspace_id
        x-prefect-api-version: tools.x-prefect-api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-concurrency-limit-tag
      description: Read Concurrency Limit By Tag
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: prefect-concurrency-limits.readconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagget
      with:
        tag: tools.tag
        account_id: tools.account_id
        workspace_id: tools.workspace_id
        x-prefect-api-version: tools.x-prefect-api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-concurrency-limit-tag
      description: Delete Concurrency Limit By Tag
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: prefect-concurrency-limits.deleteconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagdelete
      with:
        tag: tools.tag
        account_id: tools.account_id
        workspace_id: tools.workspace_id
        x-prefect-api-version: tools.x-prefect-api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: reset-concurrency-limit-tag
      description: Reset Concurrency Limit By Tag
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: prefect-concurrency-limits.resetconcurrencylimitbytagapiaccountsaccountidworkspacesworkspaceidconcurrencylimitstagtagresetpost
      with:
        tag: tools.tag
        workspace_id: tools.workspace_id
        account_id: tools.account_id
        x-prefect-api-version: tools.x-prefect-api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-concurrency-limit
      description: Read Concurrency Limit
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: prefect-concurrency-limits.readconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsidget
      with:
        id: tools.id
        account_id: tools.account_id
        workspace_id: tools.workspace_id
        x-prefect-api-version: tools.x-prefect-api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-concurrency-limit
      description: Delete Concurrency Limit
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: prefect-concurrency-limits.deleteconcurrencylimitapiaccountsaccountidworkspacesworkspaceidconcurrencylimitsiddelete
      with:
        id: tools.id
        account_id: tools.account_id
        workspace_id: tools.workspace_id
        x-prefect-api-version: tools.x-prefect-api-version
      outputParameters:
      - type: object
        mapping: $.