Phrase Strings API Reference — Releases

naftiko: 1.0.0-alpha2
info:
  label: Phrase Strings API Reference — Releases
  description: 'Phrase Strings API Reference — Releases. 6 operations. Lead operation: List releases. Self-contained Naftiko
    capability covering one Phrase business surface.'
  tags:
  - Phrase
  - Releases
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PHRASE_API_KEY: PHRASE_API_KEY
capability:
  consumes:
  - type: http
    namespace: strings-releases
    baseUri: https://api.phrase.com/v2
    description: Phrase Strings API Reference — Releases business capability. Self-contained, no shared references.
    resources:
    - name: accounts-account_id-distributions-distribution_id-releases
      path: /accounts/{account_id}/distributions/{distribution_id}/releases
      operations:
      - name: releaseslist
        method: GET
        description: List releases
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: releasecreate
        method: POST
        description: Create a release
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: accounts-account_id-distributions-distribution_id-releases-id
      path: /accounts/{account_id}/distributions/{distribution_id}/releases/{id}
      operations:
      - name: releaseshow
        method: GET
        description: Get a single release
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: releaseupdate
        method: PATCH
        description: Update a release
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: releasedelete
        method: DELETE
        description: Delete a release
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accounts-account_id-distributions-distribution_id-releases-id-publish
      path: /accounts/{account_id}/distributions/{distribution_id}/releases/{id}/publish
      operations:
      - name: releasepublish
        method: POST
        description: Publish a release
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.PHRASE_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: strings-releases-rest
    port: 8080
    description: REST adapter for Phrase Strings API Reference — Releases. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/accounts/{account-id}/distributions/{distribution-id}/releases
      name: accounts-account-id-distributions-distribution-id-releases
      description: REST surface for accounts-account_id-distributions-distribution_id-releases.
      operations:
      - method: GET
        name: releaseslist
        description: List releases
        call: strings-releases.releaseslist
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: releasecreate
        description: Create a release
        call: strings-releases.releasecreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account-id}/distributions/{distribution-id}/releases/{id}
      name: accounts-account-id-distributions-distribution-id-releases-id
      description: REST surface for accounts-account_id-distributions-distribution_id-releases-id.
      operations:
      - method: GET
        name: releaseshow
        description: Get a single release
        call: strings-releases.releaseshow
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: releaseupdate
        description: Update a release
        call: strings-releases.releaseupdate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: releasedelete
        description: Delete a release
        call: strings-releases.releasedelete
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account-id}/distributions/{distribution-id}/releases/{id}/publish
      name: accounts-account-id-distributions-distribution-id-releases-id-publish
      description: REST surface for accounts-account_id-distributions-distribution_id-releases-id-publish.
      operations:
      - method: POST
        name: releasepublish
        description: Publish a release
        call: strings-releases.releasepublish
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: strings-releases-mcp
    port: 9090
    transport: http
    description: MCP adapter for Phrase Strings API Reference — Releases. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-releases
      description: List releases
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: strings-releases.releaseslist
      outputParameters:
      - type: object
        mapping: $.
    - name: create-release
      description: Create a release
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: strings-releases.releasecreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-single-release
      description: Get a single release
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: strings-releases.releaseshow
      outputParameters:
      - type: object
        mapping: $.
    - name: update-release
      description: Update a release
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: strings-releases.releaseupdate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-release
      description: Delete a release
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: strings-releases.releasedelete
      outputParameters:
      - type: object
        mapping: $.
    - name: publish-release
      description: Publish a release
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: strings-releases.releasepublish
      outputParameters:
      - type: object
        mapping: $.