naftiko: 1.0.0-alpha2
info:
  label: Bitbucket API — properties
  description: 'Bitbucket API — properties. 12 operations. Lead operation: Update a commit application property. Self-contained
    Naftiko capability covering one Bitbucket Pipelines business surface.'
  tags:
  - Bitbucket Pipelines
  - properties
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    BITBUCKET_PIPELINES_API_KEY: BITBUCKET_PIPELINES_API_KEY
capability:
  consumes:
  - type: http
    namespace: bitbucket-pipelines-properties
    baseUri: https://api.bitbucket.org/2.0
    description: Bitbucket API — properties business capability. Self-contained, no shared references.
    resources:
    - name: repositories-workspace-repo_slug-commit-commit-properties-app_key-property_name
      path: /repositories/{workspace}/{repo_slug}/commit/{commit}/properties/{app_key}/{property_name}
      operations:
      - name: updatecommithostedpropertyvalue
        method: PUT
        description: Update a commit application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace
          in: path
          type: string
          description: The repository container; either the workspace slug or the UUID in curly braces.
          required: true
        - name: repo_slug
          in: path
          type: string
          description: The repository.
          required: true
        - name: commit
          in: path
          type: string
          description: The commit.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
        - name: _body
          in: body
          type: string
          description: The application property to create or update.
          required: true
      - name: deletecommithostedpropertyvalue
        method: DELETE
        description: Delete a commit application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace
          in: path
          type: string
          description: The repository container; either the workspace slug or the UUID in curly braces.
          required: true
        - name: repo_slug
          in: path
          type: string
          description: The repository.
          required: true
        - name: commit
          in: path
          type: string
          description: The commit.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
      - name: getcommithostedpropertyvalue
        method: GET
        description: Get a commit application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace
          in: path
          type: string
          description: The repository container; either the workspace slug or the UUID in curly braces.
          required: true
        - name: repo_slug
          in: path
          type: string
          description: The repository.
          required: true
        - name: commit
          in: path
          type: string
          description: The commit.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
    - name: repositories-workspace-repo_slug-properties-app_key-property_name
      path: /repositories/{workspace}/{repo_slug}/properties/{app_key}/{property_name}
      operations:
      - name: updaterepositoryhostedpropertyvalue
        method: PUT
        description: Update a repository application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace
          in: path
          type: string
          description: The repository container; either the workspace slug or the UUID in curly braces.
          required: true
        - name: repo_slug
          in: path
          type: string
          description: The repository.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
        - name: _body
          in: body
          type: string
          description: The application property to create or update.
          required: true
      - name: deleterepositoryhostedpropertyvalue
        method: DELETE
        description: Delete a repository application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace
          in: path
          type: string
          description: The repository container; either the workspace slug or the UUID in curly braces.
          required: true
        - name: repo_slug
          in: path
          type: string
          description: The repository.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
      - name: getrepositoryhostedpropertyvalue
        method: GET
        description: Get a repository application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace
          in: path
          type: string
          description: The repository container; either the workspace slug or the UUID in curly braces.
          required: true
        - name: repo_slug
          in: path
          type: string
          description: The repository.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
    - name: repositories-workspace-repo_slug-pullrequests-pullrequest_id-properties-app_key-
      path: /repositories/{workspace}/{repo_slug}/pullrequests/{pullrequest_id}/properties/{app_key}/{property_name}
      operations:
      - name: updatepullrequesthostedpropertyvalue
        method: PUT
        description: Update a pull request application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace
          in: path
          type: string
          description: The repository container; either the workspace slug or the UUID in curly braces.
          required: true
        - name: repo_slug
          in: path
          type: string
          description: The repository.
          required: true
        - name: pullrequest_id
          in: path
          type: string
          description: The pull request ID.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
        - name: _body
          in: body
          type: string
          description: The application property to create or update.
          required: true
      - name: deletepullrequesthostedpropertyvalue
        method: DELETE
        description: Delete a pull request application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace
          in: path
          type: string
          description: The repository container; either the workspace slug or the UUID in curly braces.
          required: true
        - name: repo_slug
          in: path
          type: string
          description: The repository.
          required: true
        - name: pullrequest_id
          in: path
          type: string
          description: The pull request ID.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
      - name: getpullrequesthostedpropertyvalue
        method: GET
        description: Get a pull request application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workspace
          in: path
          type: string
          description: The repository container; either the workspace slug or the UUID in curly braces.
          required: true
        - name: repo_slug
          in: path
          type: string
          description: The repository.
          required: true
        - name: pullrequest_id
          in: path
          type: string
          description: The pull request ID.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
    - name: users-selected_user-properties-app_key-property_name
      path: /users/{selected_user}/properties/{app_key}/{property_name}
      operations:
      - name: updateuserhostedpropertyvalue
        method: PUT
        description: Update a user application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: selected_user
          in: path
          type: string
          description: Either the UUID of the account surrounded by curly-braces, for example `{account UUID}`, OR an Atlassian
            Account ID.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
        - name: _body
          in: body
          type: string
          description: The application property to create or update.
          required: true
      - name: deleteuserhostedpropertyvalue
        method: DELETE
        description: Delete a user application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: selected_user
          in: path
          type: string
          description: Either the UUID of the account surrounded by curly-braces, for example `{account UUID}`, OR an Atlassian
            Account ID.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
      - name: retrieveuserhostedpropertyvalue
        method: GET
        description: Get a user application property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: selected_user
          in: path
          type: string
          description: Either the UUID of the account surrounded by curly-braces, for example `{account UUID}`, OR an Atlassian
            Account ID.
          required: true
        - name: app_key
          in: path
          type: string
          description: The key of the Connect app.
          required: true
        - name: property_name
          in: path
          type: string
          description: The name of the property.
          required: true
  exposes:
  - type: rest
    namespace: bitbucket-pipelines-properties-rest
    port: 8080
    description: REST adapter for Bitbucket API — properties. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/repositories/{workspace}/{repo-slug}/commit/{commit}/properties/{app-key}/{property-name}
      name: repositories-workspace-repo-slug-commit-commit-properties-app-key-property-name
      description: REST surface for repositories-workspace-repo_slug-commit-commit-properties-app_key-property_name.
      operations:
      - method: PUT
        name: updatecommithostedpropertyvalue
        description: Update a commit application property
        call: bitbucket-pipelines-properties.updatecommithostedpropertyvalue
        with:
          workspace: rest.workspace
          repo_slug: rest.repo_slug
          commit: rest.commit
          app_key: rest.app_key
          property_name: rest.property_name
          _body: rest._body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletecommithostedpropertyvalue
        description: Delete a commit application property
        call: bitbucket-pipelines-properties.deletecommithostedpropertyvalue
        with:
          workspace: rest.workspace
          repo_slug: rest.repo_slug
          commit: rest.commit
          app_key: rest.app_key
          property_name: rest.property_name
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getcommithostedpropertyvalue
        description: Get a commit application property
        call: bitbucket-pipelines-properties.getcommithostedpropertyvalue
        with:
          workspace: rest.workspace
          repo_slug: rest.repo_slug
          commit: rest.commit
          app_key: rest.app_key
          property_name: rest.property_name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{workspace}/{repo-slug}/properties/{app-key}/{property-name}
      name: repositories-workspace-repo-slug-properties-app-key-property-name
      description: REST surface for repositories-workspace-repo_slug-properties-app_key-property_name.
      operations:
      - method: PUT
        name: updaterepositoryhostedpropertyvalue
        description: Update a repository application property
        call: bitbucket-pipelines-properties.updaterepositoryhostedpropertyvalue
        with:
          workspace: rest.workspace
          repo_slug: rest.repo_slug
          app_key: rest.app_key
          property_name: rest.property_name
          _body: rest._body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleterepositoryhostedpropertyvalue
        description: Delete a repository application property
        call: bitbucket-pipelines-properties.deleterepositoryhostedpropertyvalue
        with:
          workspace: rest.workspace
          repo_slug: rest.repo_slug
          app_key: rest.app_key
          property_name: rest.property_name
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getrepositoryhostedpropertyvalue
        description: Get a repository application property
        call: bitbucket-pipelines-properties.getrepositoryhostedpropertyvalue
        with:
          workspace: rest.workspace
          repo_slug: rest.repo_slug
          app_key: rest.app_key
          property_name: rest.property_name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repositories/{workspace}/{repo-slug}/pullrequests/{pullrequest-id}/properties/{app-key}/{property-name}
      name: repositories-workspace-repo-slug-pullrequests-pullrequest-id-properties-app-key
      description: REST surface for repositories-workspace-repo_slug-pullrequests-pullrequest_id-properties-app_key-.
      operations:
      - method: PUT
        name: updatepullrequesthostedpropertyvalue
        description: Update a pull request application property
        call: bitbucket-pipelines-properties.updatepullrequesthostedpropertyvalue
        with:
          workspace: rest.workspace
          repo_slug: rest.repo_slug
          pullrequest_id: rest.pullrequest_id
          app_key: rest.app_key
          property_name: rest.property_name
          _body: rest._body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletepullrequesthostedpropertyvalue
        description: Delete a pull request application property
        call: bitbucket-pipelines-properties.deletepullrequesthostedpropertyvalue
        with:
          workspace: rest.workspace
          repo_slug: rest.repo_slug
          pullrequest_id: rest.pullrequest_id
          app_key: rest.app_key
          property_name: rest.property_name
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getpullrequesthostedpropertyvalue
        description: Get a pull request application property
        call: bitbucket-pipelines-properties.getpullrequesthostedpropertyvalue
        with:
          workspace: rest.workspace
          repo_slug: rest.repo_slug
          pullrequest_id: rest.pullrequest_id
          app_key: rest.app_key
          property_name: rest.property_name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/users/{selected-user}/properties/{app-key}/{property-name}
      name: users-selected-user-properties-app-key-property-name
      description: REST surface for users-selected_user-properties-app_key-property_name.
      operations:
      - method: PUT
        name: updateuserhostedpropertyvalue
        description: Update a user application property
        call: bitbucket-pipelines-properties.updateuserhostedpropertyvalue
        with:
          selected_user: rest.selected_user
          app_key: rest.app_key
          property_name: rest.property_name
          _body: rest._body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteuserhostedpropertyvalue
        description: Delete a user application property
        call: bitbucket-pipelines-properties.deleteuserhostedpropertyvalue
        with:
          selected_user: rest.selected_user
          app_key: rest.app_key
          property_name: rest.property_name
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: retrieveuserhostedpropertyvalue
        description: Get a user application property
        call: bitbucket-pipelines-properties.retrieveuserhostedpropertyvalue
        with:
          selected_user: rest.selected_user
          app_key: rest.app_key
          property_name: rest.property_name
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: bitbucket-pipelines-properties-mcp
    port: 9090
    transport: http
    description: MCP adapter for Bitbucket API — properties. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: update-commit-application-property
      description: Update a commit application property
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: bitbucket-pipelines-properties.updatecommithostedpropertyvalue
      with:
        workspace: tools.workspace
        repo_slug: tools.repo_slug
        commit: tools.commit
        app_key: tools.app_key
        property_name: tools.property_name
        _body: tools._body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-commit-application-property
      description: Delete a commit application property
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: bitbucket-pipelines-properties.deletecommithostedpropertyvalue
      with:
        workspace: tools.workspace
        repo_slug: tools.repo_slug
        commit: tools.commit
        app_key: tools.app_key
        property_name: tools.property_name
      outputParameters:
      - type: object
        mapping: $.
    - name: get-commit-application-property
      description: Get a commit application property
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bitbucket-pipelines-properties.getcommithostedpropertyvalue
      with:
        workspace: tools.workspace
        repo_slug: tools.repo_slug
        commit: tools.commit
        app_key: tools.app_key
        property_name: tools.property_name
      outputParameters:
      - type: object
        mapping: $.
    - name: update-repository-application-property
      description: Update a repository application property
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: bitbucket-pipelines-properties.updaterepositoryhostedpropertyvalue
      with:
        workspace: tools.workspace
        repo_slug: tools.repo_slug
        app_key: tools.app_key
        property_name: tools.property_name
        _body: tools._body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-repository-application-property
      description: Delete a repository application property
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: bitbucket-pipelines-properties.deleterepositoryhostedpropertyvalue
      with:
        workspace: tools.workspace
        repo_slug: tools.repo_slug
        app_key: tools.app_key
        property_name: tools.property_name
      outputParameters:
      - type: object
        mapping: $.
    - name: get-repository-application-property
      description: Get a repository application property
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bitbucket-pipelines-properties.getrepositoryhostedpropertyvalue
      with:
        workspace: tools.workspace
        repo_slug: tools.repo_slug
        app_key: tools.app_key
        property_name: tools.property_name
      outputParameters:
      - type: object
        mapping: $.
    - name: update-pull-request-application-property
      description: Update a pull request application property
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: bitbucket-pipelines-properties.updatepullrequesthostedpropertyvalue
      with:
        workspace: tools.workspace
        repo_slug: tools.repo_slug
        pullrequest_id: tools.pullrequest_id
        app_key: tools.app_key
        property_name: tools.property_name
        _body: tools._body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-pull-request-application-property
      description: Delete a pull request application property
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: bitbucket-pipelines-properties.deletepullrequesthostedpropertyvalue
      with:
        workspace: tools.workspace
        repo_slug: tools.repo_slug
        pullrequest_id: tools.pullrequest_id
        app_key: tools.app_key
        property_name: tools.property_name
      outputParameters:
      - type: object
        mapping: $.
    - name: get-pull-request-application-property
      description: Get a pull request application property
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bitbucket-pipelines-properties.getpullrequesthostedpropertyvalue
      with:
        workspace: tools.workspace
        repo_slug: tools.repo_slug
        pullrequest_id: tools.pullrequest_id
        app_key: tools.app_key
        property_name: tools.property_name
      outputParameters:
      - type: object
        mapping: $.
    - name: update-user-application-property
      description: Update a user application property
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: bitbucket-pipelines-properties.updateuserhostedpropertyvalue
      with:
        selected_user: tools.selected_user
        app_key: tools.app_key
        property_name: tools.property_name
        _body: tools._body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-user-application-property
      description: Delete a user application property
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: bitbucket-pipelines-properties.deleteuserhostedpropertyvalue
      with:
        selected_user: tools.selected_user
        app_key: tools.app_key
        property_name: tools.property_name
      outputParameters:
      - type: object
        mapping: $.
    - name: get-user-application-property
      description: Get a user application property
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bitbucket-pipelines-properties.retrieveuserhostedpropertyvalue
      with:
        selected_user: tools.selected_user
        app_key: tools.app_key
        property_name: tools.property_name
      outputParameters:
      - type: object
        mapping: $.