naftiko: 1.0.0-alpha2 info: label: Atlassian Bit Bucket Workspaces API — Projects description: 'Atlassian Bit Bucket Workspaces API — Projects. 22 operations. Lead operation: Atlassian List Projects In A Workspace. Self-contained Naftiko capability covering one Atlassian business surface.' tags: - Atlassian - Projects created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: ATLASSIAN_API_KEY: ATLASSIAN_API_KEY capability: consumes: - type: http namespace: rest-api-3-announcementbanner--projects baseUri: https://api.bitbucket.org/2.0 description: Atlassian Bit Bucket Workspaces API — Projects business capability. Self-contained, no shared references. resources: - 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-projects-project_key-branching-model path: /workspaces/{workspace}/projects/{project_key}/branching-model operations: - name: atlassiangetthebranchingmodelforaproject method: GET description: Atlassian Get The Branching Model For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-projects-project_key-branching-model-settings path: /workspaces/{workspace}/projects/{project_key}/branching-model/settings operations: - name: atlassiangetthebranchingmodelconfigforaproject method: GET description: Atlassian Get The Branching Model Config For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassianupdatethebranchingmodelconfigforaproject method: PUT description: Atlassian Update The Branching Model Config For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-projects-project_key-default-reviewers path: /workspaces/{workspace}/projects/{project_key}/default-reviewers operations: - name: atlassianlistthedefaultreviewersinaproject method: GET description: Atlassian List The Default Reviewers In A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-projects-project_key-default-reviewers-selected_user path: /workspaces/{workspace}/projects/{project_key}/default-reviewers/{selected_user} operations: - name: atlassianremovethespecificuserfromtheprojectsdefaultreviewers method: DELETE description: Atlassian Remove The Specific User From The Project S Default Reviewers outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassianaddthespecificuserasadefaultreviewerfortheproject method: PUT description: Atlassian Add The Specific User As A Default Reviewer For The Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-projects-project_key-deploy-keys path: /workspaces/{workspace}/projects/{project_key}/deploy-keys operations: - name: atlassianlistprojectdeploykeys method: GET description: Atlassian List Project Deploy Keys outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassiancreateaprojectdeploykey method: POST description: Atlassian Create A Project Deploy Key outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-projects-project_key-deploy-keys-key_id path: /workspaces/{workspace}/projects/{project_key}/deploy-keys/{key_id} operations: - name: atlassiangetaprojectdeploykey method: GET description: Atlassian Get A Project Deploy Key outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-projects-project_key-permissions-config-groups path: /workspaces/{workspace}/projects/{project_key}/permissions-config/groups operations: - name: atlassianlistexplicitgrouppermissionsforaproject method: GET description: Atlassian List Explicit Group Permissions For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-projects-project_key-permissions-config-groups-group_slug path: /workspaces/{workspace}/projects/{project_key}/permissions-config/groups/{group_slug} operations: - name: atlassiandeleteanexplicitgrouppermissionforaproject method: DELETE description: Atlassian Delete An Explicit Group Permission For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassiangetanexplicitgrouppermissionforaproject method: GET description: Atlassian Get An Explicit Group Permission For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassianupdateanexplicitgrouppermissionforaproject method: PUT description: Atlassian Update An Explicit Group Permission For A Project 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-permissions-config-users path: /workspaces/{workspace}/projects/{project_key}/permissions-config/users operations: - name: atlassianlistexplicituserpermissionsforaproject method: GET description: Atlassian List Explicit User Permissions For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workspaces-workspace-projects-project_key-permissions-config-users-selected_user path: /workspaces/{workspace}/projects/{project_key}/permissions-config/users/{selected_user_id} operations: - name: atlassiandeleteanexplicituserpermissionforaproject method: DELETE description: Atlassian Delete An Explicit User Permission For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassiangetanexplicituserpermissionforaproject method: GET description: Atlassian Get An Explicit User Permission For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: atlassianupdateanexplicituserpermissionforaproject method: PUT description: Atlassian Update An Explicit User Permission For A Project outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false exposes: - type: rest namespace: rest-api-3-announcementbanner--projects-rest port: 8080 description: REST adapter for Atlassian Bit Bucket Workspaces API — Projects. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - 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: rest-api-3-announcementbanner--projects.atlassianlistprojectsinaworkspace outputParameters: - type: object mapping: $. - method: POST name: atlassiancreateaprojectinaworkspace description: Atlassian Create A Project In A Workspace call: rest-api-3-announcementbanner--projects.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: rest-api-3-announcementbanner--projects.atlassiandeleteaprojectforaworkspace outputParameters: - type: object mapping: $. - method: GET name: atlassiangetaprojectforaworkspace description: Atlassian Get A Project For A Workspace call: rest-api-3-announcementbanner--projects.atlassiangetaprojectforaworkspace outputParameters: - type: object mapping: $. - method: PUT name: atlassianupdateaprojectforaworkspace description: Atlassian Update A Project For A Workspace call: rest-api-3-announcementbanner--projects.atlassianupdateaprojectforaworkspace with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/branching-model name: workspaces-workspace-projects-project-key-branching-model description: REST surface for workspaces-workspace-projects-project_key-branching-model. operations: - method: GET name: atlassiangetthebranchingmodelforaproject description: Atlassian Get The Branching Model For A Project call: rest-api-3-announcementbanner--projects.atlassiangetthebranchingmodelforaproject outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/branching-model/settings name: workspaces-workspace-projects-project-key-branching-model-settings description: REST surface for workspaces-workspace-projects-project_key-branching-model-settings. operations: - method: GET name: atlassiangetthebranchingmodelconfigforaproject description: Atlassian Get The Branching Model Config For A Project call: rest-api-3-announcementbanner--projects.atlassiangetthebranchingmodelconfigforaproject outputParameters: - type: object mapping: $. - method: PUT name: atlassianupdatethebranchingmodelconfigforaproject description: Atlassian Update The Branching Model Config For A Project call: rest-api-3-announcementbanner--projects.atlassianupdatethebranchingmodelconfigforaproject outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/default-reviewers name: workspaces-workspace-projects-project-key-default-reviewers description: REST surface for workspaces-workspace-projects-project_key-default-reviewers. operations: - method: GET name: atlassianlistthedefaultreviewersinaproject description: Atlassian List The Default Reviewers In A Project call: rest-api-3-announcementbanner--projects.atlassianlistthedefaultreviewersinaproject outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/default-reviewers/{selected-user} name: workspaces-workspace-projects-project-key-default-reviewers-selected-user description: REST surface for workspaces-workspace-projects-project_key-default-reviewers-selected_user. operations: - method: DELETE name: atlassianremovethespecificuserfromtheprojectsdefaultreviewers description: Atlassian Remove The Specific User From The Project S Default Reviewers call: rest-api-3-announcementbanner--projects.atlassianremovethespecificuserfromtheprojectsdefaultreviewers outputParameters: - type: object mapping: $. - method: PUT name: atlassianaddthespecificuserasadefaultreviewerfortheproject description: Atlassian Add The Specific User As A Default Reviewer For The Project call: rest-api-3-announcementbanner--projects.atlassianaddthespecificuserasadefaultreviewerfortheproject outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/deploy-keys name: workspaces-workspace-projects-project-key-deploy-keys description: REST surface for workspaces-workspace-projects-project_key-deploy-keys. operations: - method: GET name: atlassianlistprojectdeploykeys description: Atlassian List Project Deploy Keys call: rest-api-3-announcementbanner--projects.atlassianlistprojectdeploykeys outputParameters: - type: object mapping: $. - method: POST name: atlassiancreateaprojectdeploykey description: Atlassian Create A Project Deploy Key call: rest-api-3-announcementbanner--projects.atlassiancreateaprojectdeploykey outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/deploy-keys/{key-id} name: workspaces-workspace-projects-project-key-deploy-keys-key-id description: REST surface for workspaces-workspace-projects-project_key-deploy-keys-key_id. operations: - method: GET name: atlassiangetaprojectdeploykey description: Atlassian Get A Project Deploy Key call: rest-api-3-announcementbanner--projects.atlassiangetaprojectdeploykey outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/permissions-config/groups name: workspaces-workspace-projects-project-key-permissions-config-groups description: REST surface for workspaces-workspace-projects-project_key-permissions-config-groups. operations: - method: GET name: atlassianlistexplicitgrouppermissionsforaproject description: Atlassian List Explicit Group Permissions For A Project call: rest-api-3-announcementbanner--projects.atlassianlistexplicitgrouppermissionsforaproject outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/permissions-config/groups/{group-slug} name: workspaces-workspace-projects-project-key-permissions-config-groups-group-slug description: REST surface for workspaces-workspace-projects-project_key-permissions-config-groups-group_slug. operations: - method: DELETE name: atlassiandeleteanexplicitgrouppermissionforaproject description: Atlassian Delete An Explicit Group Permission For A Project call: rest-api-3-announcementbanner--projects.atlassiandeleteanexplicitgrouppermissionforaproject outputParameters: - type: object mapping: $. - method: GET name: atlassiangetanexplicitgrouppermissionforaproject description: Atlassian Get An Explicit Group Permission For A Project call: rest-api-3-announcementbanner--projects.atlassiangetanexplicitgrouppermissionforaproject outputParameters: - type: object mapping: $. - method: PUT name: atlassianupdateanexplicitgrouppermissionforaproject description: Atlassian Update An Explicit Group Permission For A Project call: rest-api-3-announcementbanner--projects.atlassianupdateanexplicitgrouppermissionforaproject with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/permissions-config/users name: workspaces-workspace-projects-project-key-permissions-config-users description: REST surface for workspaces-workspace-projects-project_key-permissions-config-users. operations: - method: GET name: atlassianlistexplicituserpermissionsforaproject description: Atlassian List Explicit User Permissions For A Project call: rest-api-3-announcementbanner--projects.atlassianlistexplicituserpermissionsforaproject outputParameters: - type: object mapping: $. - path: /v1/workspaces/{workspace}/projects/{project-key}/permissions-config/users/{selected-user-id} name: workspaces-workspace-projects-project-key-permissions-config-users-selected-user description: REST surface for workspaces-workspace-projects-project_key-permissions-config-users-selected_user. operations: - method: DELETE name: atlassiandeleteanexplicituserpermissionforaproject description: Atlassian Delete An Explicit User Permission For A Project call: rest-api-3-announcementbanner--projects.atlassiandeleteanexplicituserpermissionforaproject outputParameters: - type: object mapping: $. - method: GET name: atlassiangetanexplicituserpermissionforaproject description: Atlassian Get An Explicit User Permission For A Project call: rest-api-3-announcementbanner--projects.atlassiangetanexplicituserpermissionforaproject outputParameters: - type: object mapping: $. - method: PUT name: atlassianupdateanexplicituserpermissionforaproject description: Atlassian Update An Explicit User Permission For A Project call: rest-api-3-announcementbanner--projects.atlassianupdateanexplicituserpermissionforaproject with: body: rest.body outputParameters: - type: object mapping: $. - type: mcp namespace: rest-api-3-announcementbanner--projects-mcp port: 9090 transport: http description: MCP adapter for Atlassian Bit Bucket Workspaces API — Projects. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: atlassian-list-projects-workspace description: Atlassian List Projects In A Workspace hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.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: rest-api-3-announcementbanner--projects.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: rest-api-3-announcementbanner--projects.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: rest-api-3-announcementbanner--projects.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: rest-api-3-announcementbanner--projects.atlassianupdateaprojectforaworkspace with: body: tools.body outputParameters: - type: object mapping: $. - name: atlassian-get-branching-model-project description: Atlassian Get The Branching Model For A Project hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassiangetthebranchingmodelforaproject outputParameters: - type: object mapping: $. - name: atlassian-get-branching-model-config description: Atlassian Get The Branching Model Config For A Project hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassiangetthebranchingmodelconfigforaproject outputParameters: - type: object mapping: $. - name: atlassian-update-branching-model-config description: Atlassian Update The Branching Model Config For A Project hints: readOnly: false destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassianupdatethebranchingmodelconfigforaproject outputParameters: - type: object mapping: $. - name: atlassian-list-default-reviewers-project description: Atlassian List The Default Reviewers In A Project hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassianlistthedefaultreviewersinaproject outputParameters: - type: object mapping: $. - name: atlassian-remove-specific-user-project description: Atlassian Remove The Specific User From The Project S Default Reviewers hints: readOnly: false destructive: true idempotent: true call: rest-api-3-announcementbanner--projects.atlassianremovethespecificuserfromtheprojectsdefaultreviewers outputParameters: - type: object mapping: $. - name: atlassian-add-specific-user-default description: Atlassian Add The Specific User As A Default Reviewer For The Project hints: readOnly: false destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassianaddthespecificuserasadefaultreviewerfortheproject outputParameters: - type: object mapping: $. - name: atlassian-list-project-deploy-keys description: Atlassian List Project Deploy Keys hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassianlistprojectdeploykeys outputParameters: - type: object mapping: $. - name: atlassian-create-project-deploy-key description: Atlassian Create A Project Deploy Key hints: readOnly: false destructive: false idempotent: false call: rest-api-3-announcementbanner--projects.atlassiancreateaprojectdeploykey outputParameters: - type: object mapping: $. - name: atlassian-get-project-deploy-key description: Atlassian Get A Project Deploy Key hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassiangetaprojectdeploykey outputParameters: - type: object mapping: $. - name: atlassian-list-explicit-group-permissions description: Atlassian List Explicit Group Permissions For A Project hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassianlistexplicitgrouppermissionsforaproject outputParameters: - type: object mapping: $. - name: atlassian-delete-explicit-group-permission description: Atlassian Delete An Explicit Group Permission For A Project hints: readOnly: false destructive: true idempotent: true call: rest-api-3-announcementbanner--projects.atlassiandeleteanexplicitgrouppermissionforaproject outputParameters: - type: object mapping: $. - name: atlassian-get-explicit-group-permission description: Atlassian Get An Explicit Group Permission For A Project hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassiangetanexplicitgrouppermissionforaproject outputParameters: - type: object mapping: $. - name: atlassian-update-explicit-group-permission description: Atlassian Update An Explicit Group Permission For A Project hints: readOnly: false destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassianupdateanexplicitgrouppermissionforaproject with: body: tools.body outputParameters: - type: object mapping: $. - name: atlassian-list-explicit-user-permissions description: Atlassian List Explicit User Permissions For A Project hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassianlistexplicituserpermissionsforaproject outputParameters: - type: object mapping: $. - name: atlassian-delete-explicit-user-permission description: Atlassian Delete An Explicit User Permission For A Project hints: readOnly: false destructive: true idempotent: true call: rest-api-3-announcementbanner--projects.atlassiandeleteanexplicituserpermissionforaproject outputParameters: - type: object mapping: $. - name: atlassian-get-explicit-user-permission description: Atlassian Get An Explicit User Permission For A Project hints: readOnly: true destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassiangetanexplicituserpermissionforaproject outputParameters: - type: object mapping: $. - name: atlassian-update-explicit-user-permission description: Atlassian Update An Explicit User Permission For A Project hints: readOnly: false destructive: false idempotent: true call: rest-api-3-announcementbanner--projects.atlassianupdateanexplicituserpermissionforaproject with: body: tools.body outputParameters: - type: object mapping: $.