naftiko: 1.0.0-alpha2 info: label: Atlassian Bit Bucket Workspaces API — Workspaces description: 'Atlassian Bit Bucket Workspaces API — Workspaces. 21 operations. Lead operation: Atlassian Get a Workspace. Self-contained Naftiko capability covering one Atlassian business surface.' tags: - Atlassian - Workspaces created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: ATLASSIAN_API_KEY: ATLASSIAN_API_KEY capability: consumes: - type: http namespace: bitbucket-workspaces-workspaces baseUri: https://api.bitbucket.org/2.0 description: Atlassian Bit Bucket Workspaces API — Workspaces business capability. Self-contained, no shared references. resources: - name: workspaces-workspace path: /workspaces/{workspace} operations: - name: atlassiangetaworkspace method: GET description: Atlassian Get a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-hooks path: /workspaces/{workspace}/hooks operations: - name: atlassianlistwebhooksforaworkspace method: GET description: Atlassian List Webhooks for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassiancreateawebhookforaworkspace method: POST description: Atlassian Create a Webhook for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-hooks-uid path: /workspaces/{workspace}/hooks/{uid} operations: - name: atlassiandeleteawebhookforaworkspace method: DELETE description: Atlassian Delete a Webhook for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassianupdateawebhookforaworkspace method: PUT description: Atlassian Update a Webhook for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-members path: /workspaces/{workspace}/members operations: - name: atlassianlistusersinaworkspace method: GET description: Atlassian List Users in a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-members-member path: /workspaces/{workspace}/members/{member} operations: - name: atlassiangetusermembershipforaworkspace method: GET description: Atlassian Get User Membership for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-permissions path: /workspaces/{workspace}/permissions operations: - name: atlassianlistuserpermissionsinaworkspace method: GET description: Atlassian List User Permissions in a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: q in: query type: string description: Query string to narrow down the response as per - name: workspaces-workspace-permissions-repositories path: /workspaces/{workspace}/permissions/repositories operations: - name: atlassianlistallrepositorypermissionsforaworkspace method: GET description: Atlassian List All Repository Permissions for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: q in: query type: string description: Query string to narrow down the response as per - name: sort in: query type: string description: Name of a response property sort the result by as per - name: workspaces-workspace-permissions-repositories-repo_slug path: /workspaces/{workspace}/permissions/repositories/{repo_slug} operations: - name: atlassianlistarepositorypermissionsforaworkspace method: GET description: Atlassian List a Repository Permissions for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: q in: query type: string description: Query string to narrow down the response as per - name: sort in: query type: string description: Name of a response property sort the result by as per - name: workspaces-workspace-pipelines-config-variables path: /workspaces/{workspace}/pipelines-config/variables operations: - name: atlassiangetpipelinevariablesforworkspace method: GET description: Atlassian List Variables for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: workspace in: path type: string description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example `{workspace UUID}`. required: true - name: atlassiancreatepipelinevariableforworkspace method: POST description: Atlassian Create a Variable for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: workspace in: path type: string description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example `{workspace UUID}`. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: workspaces-workspace-pipelines-config-variables-variable_uuid path: /workspaces/{workspace}/pipelines-config/variables/{variable_uuid} operations: - name: atlassiangetpipelinevariableforworkspace method: GET description: Atlassian Get Variable for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: workspace in: path type: string description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example `{workspace UUID}`. required: true - name: variable_uuid in: path type: string description: The UUID of the variable to retrieve. required: true - name: atlassianupdatepipelinevariableforworkspace method: PUT description: Atlassian Update Variable for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: workspace in: path type: string description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example `{workspace UUID}`. required: true - name: variable_uuid in: path type: string description: The UUID of the variable. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: atlassiandeletepipelinevariableforworkspace method: DELETE description: Atlassian Delete a Variable for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: workspace in: path type: string description: This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example `{workspace UUID}`. required: true - name: variable_uuid in: path type: string description: The UUID of the variable to delete. required: true - name: workspaces-workspace-projects path: /workspaces/{workspace}/projects operations: - name: atlassianlistprojectsinaworkspace method: GET description: Atlassian List Projects in a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassiancreateaprojectinaworkspace method: POST description: Atlassian Create a Project in a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: workspaces-workspace-projects-project_key path: /workspaces/{workspace}/projects/{project_key} operations: - name: atlassiandeleteaprojectforaworkspace method: DELETE description: Atlassian Delete a Project for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassiangetaprojectforaworkspace method: GET description: Atlassian Get a Project for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassianupdateaprojectforaworkspace method: PUT description: Atlassian Update a Project for a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: workspaces-workspace-search-code path: /workspaces/{workspace}/search/code operations: - name: atlassiansearchworkspace method: GET description: Atlassian Search for Code in a Workspace outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: workspace in: path type: string description: The workspace to search in; either the slug or the UUID in curly braces required: true - name: search_query in: query type: string description: The search query required: true - name: page in: query type: integer description: Which page of the search results to retrieve - name: pagelen in: query type: integer description: How many search results to retrieve per page exposes: - type: rest namespace: bitbucket-workspaces-workspaces-rest port: 8080 description: REST adapter for Atlassian Bit Bucket Workspaces API — Workspaces. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/workspaces/{workspace} name: workspaces-workspace description: REST surface for workspaces-workspace. operations: - method: GET name: atlassiangetaworkspace description: Atlassian Get a Workspace call: bitbucket-workspaces-workspaces.atlassiangetaworkspace outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/hooks name: workspaces-workspace-hooks description: REST surface for workspaces-workspace-hooks. operations: - method: GET name: atlassianlistwebhooksforaworkspace description: Atlassian List Webhooks for a Workspace call: bitbucket-workspaces-workspaces.atlassianlistwebhooksforaworkspace outputParameters: - type: object mapping: $. - method: POST name: atlassiancreateawebhookforaworkspace description: Atlassian Create a Webhook for a Workspace call: bitbucket-workspaces-workspaces.atlassiancreateawebhookforaworkspace outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/hooks/{uid} name: workspaces-workspace-hooks-uid description: REST surface for workspaces-workspace-hooks-uid. operations: - method: DELETE name: atlassiandeleteawebhookforaworkspace description: Atlassian Delete a Webhook for a Workspace call: bitbucket-workspaces-workspaces.atlassiandeleteawebhookforaworkspace outputParameters: - type: object mapping: $. - method: PUT name: atlassianupdateawebhookforaworkspace description: Atlassian Update a Webhook for a Workspace call: bitbucket-workspaces-workspaces.atlassianupdateawebhookforaworkspace outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/members name: workspaces-workspace-members description: REST surface for workspaces-workspace-members. operations: - method: GET name: atlassianlistusersinaworkspace description: Atlassian List Users in a Workspace call: bitbucket-workspaces-workspaces.atlassianlistusersinaworkspace outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/members/{member} name: workspaces-workspace-members-member description: REST surface for workspaces-workspace-members-member. operations: - method: GET name: atlassiangetusermembershipforaworkspace description: Atlassian Get User Membership for a Workspace call: bitbucket-workspaces-workspaces.atlassiangetusermembershipforaworkspace outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/permissions name: workspaces-workspace-permissions description: REST surface for workspaces-workspace-permissions. operations: - method: GET name: atlassianlistuserpermissionsinaworkspace description: Atlassian List User Permissions in a Workspace call: bitbucket-workspaces-workspaces.atlassianlistuserpermissionsinaworkspace with: q: rest.q outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/permissions/repositories name: workspaces-workspace-permissions-repositories description: REST surface for workspaces-workspace-permissions-repositories. operations: - method: GET name: atlassianlistallrepositorypermissionsforaworkspace description: Atlassian List All Repository Permissions for a Workspace call: bitbucket-workspaces-workspaces.atlassianlistallrepositorypermissionsforaworkspace with: q: rest.q sort: rest.sort outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/permissions/repositories/{repo-slug} name: workspaces-workspace-permissions-repositories-repo-slug description: REST surface for workspaces-workspace-permissions-repositories-repo_slug. operations: - method: GET name: atlassianlistarepositorypermissionsforaworkspace description: Atlassian List a Repository Permissions for a Workspace call: bitbucket-workspaces-workspaces.atlassianlistarepositorypermissionsforaworkspace with: q: rest.q sort: rest.sort outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/pipelines-config/variables name: workspaces-workspace-pipelines-config-variables description: REST surface for workspaces-workspace-pipelines-config-variables. operations: - method: GET name: atlassiangetpipelinevariablesforworkspace description: Atlassian List Variables for a Workspace call: bitbucket-workspaces-workspaces.atlassiangetpipelinevariablesforworkspace with: workspace: rest.workspace outputParameters: - type: object mapping: $. - method: POST name: atlassiancreatepipelinevariableforworkspace description: Atlassian Create a Variable for a Workspace call: bitbucket-workspaces-workspaces.atlassiancreatepipelinevariableforworkspace with: workspace: rest.workspace body: rest.body outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/pipelines-config/variables/{variable-uuid} name: workspaces-workspace-pipelines-config-variables-variable-uuid description: REST surface for workspaces-workspace-pipelines-config-variables-variable_uuid. operations: - method: GET name: atlassiangetpipelinevariableforworkspace description: Atlassian Get Variable for a Workspace call: bitbucket-workspaces-workspaces.atlassiangetpipelinevariableforworkspace with: workspace: rest.workspace variable_uuid: rest.variable_uuid outputParameters: - type: object mapping: $. - method: PUT name: atlassianupdatepipelinevariableforworkspace description: Atlassian Update Variable for a Workspace call: bitbucket-workspaces-workspaces.atlassianupdatepipelinevariableforworkspace with: workspace: rest.workspace variable_uuid: rest.variable_uuid body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: atlassiandeletepipelinevariableforworkspace description: Atlassian Delete a Variable for a Workspace call: bitbucket-workspaces-workspaces.atlassiandeletepipelinevariableforworkspace with: workspace: rest.workspace variable_uuid: rest.variable_uuid outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects name: workspaces-workspace-projects description: REST surface for workspaces-workspace-projects. operations: - method: GET name: atlassianlistprojectsinaworkspace description: Atlassian List Projects in a Workspace call: bitbucket-workspaces-workspaces.atlassianlistprojectsinaworkspace outputParameters: - type: object mapping: $. - method: POST name: atlassiancreateaprojectinaworkspace description: Atlassian Create a Project in a Workspace call: bitbucket-workspaces-workspaces.atlassiancreateaprojectinaworkspace with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key} name: workspaces-workspace-projects-project-key description: REST surface for workspaces-workspace-projects-project_key. operations: - method: DELETE name: atlassiandeleteaprojectforaworkspace description: Atlassian Delete a Project for a Workspace call: bitbucket-workspaces-workspaces.atlassiandeleteaprojectforaworkspace outputParameters: - type: object mapping: $. - method: GET name: atlassiangetaprojectforaworkspace description: Atlassian Get a Project for a Workspace call: bitbucket-workspaces-workspaces.atlassiangetaprojectforaworkspace outputParameters: - type: object mapping: $. - method: PUT name: atlassianupdateaprojectforaworkspace description: Atlassian Update a Project for a Workspace call: bitbucket-workspaces-workspaces.atlassianupdateaprojectforaworkspace with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/search/code name: workspaces-workspace-search-code description: REST surface for workspaces-workspace-search-code. operations: - method: GET name: atlassiansearchworkspace description: Atlassian Search for Code in a Workspace call: bitbucket-workspaces-workspaces.atlassiansearchworkspace with: workspace: rest.workspace search_query: rest.search_query page: rest.page pagelen: rest.pagelen outputParameters: - type: object mapping: $. - type: mcp namespace: bitbucket-workspaces-workspaces-mcp port: 9090 transport: http description: MCP adapter for Atlassian Bit Bucket Workspaces API — Workspaces. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: atlassian-get-workspace description: Atlassian Get a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassiangetaworkspace outputParameters: - type: object mapping: $. - name: atlassian-list-webhooks-workspace description: Atlassian List Webhooks for a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassianlistwebhooksforaworkspace outputParameters: - type: object mapping: $. - name: atlassian-create-webhook-workspace description: Atlassian Create a Webhook for a Workspace hints: readOnly: false destructive: false idempotent: false call: bitbucket-workspaces-workspaces.atlassiancreateawebhookforaworkspace outputParameters: - type: object mapping: $. - name: atlassian-delete-webhook-workspace description: Atlassian Delete a Webhook for a Workspace hints: readOnly: false destructive: true idempotent: true call: bitbucket-workspaces-workspaces.atlassiandeleteawebhookforaworkspace outputParameters: - type: object mapping: $. - name: atlassian-update-webhook-workspace description: Atlassian Update a Webhook for a Workspace hints: readOnly: false destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassianupdateawebhookforaworkspace outputParameters: - type: object mapping: $. - name: atlassian-list-users-workspace description: Atlassian List Users in a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassianlistusersinaworkspace outputParameters: - type: object mapping: $. - name: atlassian-get-user-membership-workspace description: Atlassian Get User Membership for a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassiangetusermembershipforaworkspace outputParameters: - type: object mapping: $. - name: atlassian-list-user-permissions-workspace description: Atlassian List User Permissions in a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassianlistuserpermissionsinaworkspace with: q: tools.q outputParameters: - type: object mapping: $. - name: atlassian-list-all-repository-permissions description: Atlassian List All Repository Permissions for a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassianlistallrepositorypermissionsforaworkspace with: q: tools.q sort: tools.sort outputParameters: - type: object mapping: $. - name: atlassian-list-repository-permissions-workspace description: Atlassian List a Repository Permissions for a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassianlistarepositorypermissionsforaworkspace with: q: tools.q sort: tools.sort outputParameters: - type: object mapping: $. - name: atlassian-list-variables-workspace description: Atlassian List Variables for a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassiangetpipelinevariablesforworkspace with: workspace: tools.workspace outputParameters: - type: object mapping: $. - name: atlassian-create-variable-workspace description: Atlassian Create a Variable for a Workspace hints: readOnly: false destructive: false idempotent: false call: bitbucket-workspaces-workspaces.atlassiancreatepipelinevariableforworkspace with: workspace: tools.workspace body: tools.body outputParameters: - type: object mapping: $. - name: atlassian-get-variable-workspace description: Atlassian Get Variable for a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassiangetpipelinevariableforworkspace with: workspace: tools.workspace variable_uuid: tools.variable_uuid outputParameters: - type: object mapping: $. - name: atlassian-update-variable-workspace description: Atlassian Update Variable for a Workspace hints: readOnly: false destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassianupdatepipelinevariableforworkspace with: workspace: tools.workspace variable_uuid: tools.variable_uuid body: tools.body outputParameters: - type: object mapping: $. - name: atlassian-delete-variable-workspace description: Atlassian Delete a Variable for a Workspace hints: readOnly: false destructive: true idempotent: true call: bitbucket-workspaces-workspaces.atlassiandeletepipelinevariableforworkspace with: workspace: tools.workspace variable_uuid: tools.variable_uuid outputParameters: - type: object mapping: $. - name: atlassian-list-projects-workspace description: Atlassian List Projects in a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassianlistprojectsinaworkspace outputParameters: - type: object mapping: $. - name: atlassian-create-project-workspace description: Atlassian Create a Project in a Workspace hints: readOnly: false destructive: false idempotent: false call: bitbucket-workspaces-workspaces.atlassiancreateaprojectinaworkspace with: body: tools.body outputParameters: - type: object mapping: $. - name: atlassian-delete-project-workspace description: Atlassian Delete a Project for a Workspace hints: readOnly: false destructive: true idempotent: true call: bitbucket-workspaces-workspaces.atlassiandeleteaprojectforaworkspace outputParameters: - type: object mapping: $. - name: atlassian-get-project-workspace description: Atlassian Get a Project for a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassiangetaprojectforaworkspace outputParameters: - type: object mapping: $. - name: atlassian-update-project-workspace description: Atlassian Update a Project for a Workspace hints: readOnly: false destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassianupdateaprojectforaworkspace with: body: tools.body outputParameters: - type: object mapping: $. - name: atlassian-search-code-workspace description: Atlassian Search for Code in a Workspace hints: readOnly: true destructive: false idempotent: true call: bitbucket-workspaces-workspaces.atlassiansearchworkspace with: workspace: tools.workspace search_query: tools.search_query page: tools.page pagelen: tools.pagelen outputParameters: - type: object mapping: $.