## Submit feedback for an objective

`objectives.feedback.create(objective_id, **kwargs) -> ObjectiveFeedback`

**post** `/v1/workspaces/{workspaceId}/objectives/{objectiveId}/feedback`

Submits feedback for an objective's execution. Feedback scores are used by the agent variation scoring system to evaluate and rank variation performance.

### Parameters

- `workspace_id: String`

- `objective_id: String`

- `data: ObjectiveFeedbackData`

  - `comment: String`

    Optional human-readable comment explaining the feedback

  - `score: Float`

    A score between -1.0 and 1.0 representing the quality of the objective's execution.
    -1.0 is the worst possible score, 0.0 is neutral, and 1.0 is the best.

- `metadata: CreateOperationMetadata`

  CreateOperationMetadata contains the user-provided fields for creating
  an operation. Read-only fields (id, account_id, workspace_id, created_at, profile_id)
  are excluded since they are set by the server.

  - `external_id: String`

    External ID for the operation (e.g., a workflow ID from an external system)

  - `labels: Hash[Symbol, String]`

    Arbitrary key-value pairs for categorization and filtering
    Examples: {"priority": "high", "source": "api", "workflow": "onboarding"}

### Returns

- `class ObjectiveFeedback`

  ObjectiveFeedback represents feedback submitted for an objective's execution.
  Feedback is used to score agent variations and improve agent performance over time.

  - `data: ObjectiveFeedbackData`

    - `comment: String`

      Optional human-readable comment explaining the feedback

    - `score: Float`

      A score between -1.0 and 1.0 representing the quality of the objective's execution.
      -1.0 is the worst possible score, 0.0 is neutral, and 1.0 is the best.

  - `metadata: OperationMetadata`

    Metadata for ephemeral operations and activities (e.g., objectives, executions, runs)

    - `id: String`

      Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...")

    - `account_id: String`

      Account this operation belongs to for multi-tenant isolation (prefixed ULID)

    - `created_at: Time`

      Timestamp when this operation was created
      ULID includes timestamp information, but this explicit field enables easier querying

    - `profile_id: String`

      ID of the actor (user or service account) that created this operation

    - `workspace_id: String`

      Workspace this operation belongs to for organizational grouping (prefixed ULID)

    - `external_id: String`

      External ID for the operation (e.g., a workflow ID from an external system)

    - `labels: Hash[Symbol, String]`

      Arbitrary key-value pairs for categorization and filtering
      Examples: {"priority": "high", "source": "api", "workflow": "onboarding"}

  - `info: ObjectiveFeedbackInfo`

    - `agent_variation: BareMetadata`

      BareMetadata contains the minimal metadata for a resource: the ID and an
      optional human-readable name. These are used for reference fields where the
      full metadata (account scoping, timestamps, labels, external IDs) is not
      needed — e.g., the tool references inside an agent variation spec or the
      tools assigned to an objective. Both fields are server-populated; clients
      provide IDs through sibling fields rather than by constructing a
      BareMetadata themselves.

      - `id: String`

      - `name: String`

        Human-readable name of the referenced resource, populated by the server
        on reads for convenience. Absent on references to resources that do not
        have a name (e.g., objective tasks).

    - `objective: BareMetadata`

      BareMetadata contains the minimal metadata for a resource: the ID and an
      optional human-readable name. These are used for reference fields where the
      full metadata (account scoping, timestamps, labels, external IDs) is not
      needed — e.g., the tool references inside an agent variation spec or the
      tools assigned to an objective. Both fields are server-populated; clients
      provide IDs through sibling fields rather than by constructing a
      BareMetadata themselves.

    - `submitted_by: Profile`

      A profile identifies a user or non-human principal (such as an API key)
      at the account level. Profiles are account-scoped and can be granted access
      to multiple workspaces.

      - `metadata: AccountResourceMetadata`

        AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace.

        - `id: String`

          Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...")

        - `account_id: String`

          Account this resource belongs to for multi-tenant isolation (prefixed ULID)

        - `name: String`

          Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool")
          Required for resources that users interact with directly

        - `profile_id: String`

        - `external_id: String`

          External ID for the resource (e.g., a workflow ID from an external system)

        - `labels: Hash[Symbol, String]`

          Arbitrary key-value pairs for categorization and filtering
          Examples: {"environment": "production", "team": "platform", "version": "v2"}

      - `spec: ProfileSpec`

        Configuration for a profile.

        - `type: :PROFILE_TYPE_UNSPECIFIED | :PROFILE_TYPE_USER | :PROFILE_TYPE_API_KEY | :PROFILE_TYPE_SYSTEM`

          Whether this profile represents a human user, an API key, or a system
          principal.

          - `:PROFILE_TYPE_UNSPECIFIED`

          - `:PROFILE_TYPE_USER`

          - `:PROFILE_TYPE_API_KEY`

          - `:PROFILE_TYPE_SYSTEM`

        - `email: String`

          Email address of the profile. Required and unique within an account for
          user profiles.

        - `name: String`

          Display name (e.g., "Bobby Tables").

### Example

```ruby
require "cadenya"

cadenya = Cadenya::Client.new(api_key: "My API Key")

objective_feedback = cadenya.objectives.feedback.create("objectiveId", workspace_id: "workspaceId", data: {}, metadata: {})

puts(objective_feedback)
```

#### Response

```json
{
  "data": {
    "comment": "comment",
    "score": 0
  },
  "metadata": {
    "id": "id",
    "accountId": "accountId",
    "createdAt": "2019-12-27T18:11:19.117Z",
    "profileId": "profileId",
    "workspaceId": "workspaceId",
    "externalId": "externalId",
    "labels": {
      "foo": "string"
    }
  },
  "info": {
    "agentVariation": {
      "id": "id",
      "name": "name"
    },
    "objective": {
      "id": "id",
      "name": "name"
    },
    "submittedBy": {
      "metadata": {
        "id": "id",
        "accountId": "accountId",
        "name": "name",
        "profileId": "profileId",
        "externalId": "externalId",
        "labels": {
          "foo": "string"
        }
      },
      "spec": {
        "type": "PROFILE_TYPE_UNSPECIFIED",
        "email": "email",
        "name": "name"
      }
    }
  }
}
```