> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plungeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolve a task to one tool, its operation and an example call, with a…

> Resolve a task to one tool, its operation and an example call, with a calibrated confidence


## OpenAPI

```yaml openapi.json post /v1/discovery/resolve
openapi: 3.1.0
info:
  title: Ocean One API
  version: 2.1.0
servers:
  - url: https://api.plungeai.com
paths:
  /v1/discovery/resolve:
    post:
      summary: Resolve a task to one tool, its operation and an example call, with a calibrated confidence
      security:
        - ozkBearer: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                task:
                  type: string
                  description: What you want done, in plain language
                kinds:
                  type: array
                  items:
                    type: string
                  maxItems: 8
                  description: "Card types to consider (agent, workflow, connector, mcp_server, skill, plugin, …); plural kinds are accepted aliases. Default: every discoverable kind"
                category:
                  type: string
                status:
                  type: string
                  default: active
              required:
                - task
      responses:
        "200":
          description: Resolve decision
          content:
            application/json:
              schema:
                type: object
                properties:
                  outcome:
                    type: string
                    enum:
                      - match
                      - uncertain
                      - none
                  tool:
                    type: object
                    properties:
                      id:
                        type: string
                      kind:
                        type: string
                      type:
                        type: string
                      name:
                        type: string
                      description:
                        type: string
                      category:
                        type: string
                      status:
                        type: string
                  operation:
                    type: object
                    properties:
                      name:
                        type: string
                      purpose:
                        type: string
                      gated:
                        type: boolean
                  call:
                    type: object
                    properties:
                      required_params:
                        type: array
                        items:
                          type: string
                      example_cnl:
                        type: string
                  confidence:
                    type:
                      - number
                      - "null"
                    description: null on the keyword fallback (decision model unavailable)
                  alternatives:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        kind:
                          type: string
                        name:
                          type: string
                        p:
                          type: number
                  mode:
                    type: string
                    enum:
                      - shadow
                      - act
        "400":
          description: invalid_json — body missing or no task
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: rate_limited — Retry-After header
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
components:
  schemas:
    Error:
      type: object
      description: Standard error envelope. Every error response also carries an `X-Error-Code` response header equal to error.code, so a client branches on the header regardless of the negotiated body format (json | yaml | markdown | text). When the request created an execution, the `X-Execution-Id` response header is also set. Errors follow the negotiated format like success bodies.
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          additionalProperties: true
      required:
        - error
  securitySchemes:
    ozkBearer:
      type: http
      scheme: bearer
      description: "ozk_ platform API key (Authorization: Bearer ozk_…)"
```