Create Objective | Taktoria API

{
  "id": "id",
  "organizationId": "organizationId",
  "title": "title",
  "period": "QUARTERLY",
  "year": 1,
  "priority": "P1",
  "visibility": "PUBLIC",
  "weight": 1.1,
  "keyResults": [
    {
      "id": "id",
      "objectiveId": "objectiveId",
      "title": "title",
      "weight": 1.1,
      "sortOrder": 1,
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "score": 1.1
    },
    {
      "id": "id",
      "objectiveId": "objectiveId",
      "title": "title",
      "weight": 1.1,
      "sortOrder": 1,
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "score": 1.1
    }
  ],
  "archived": true,
  "createdAt": "2024-01-15T09:30:00Z",
  "updatedAt": "2024-01-15T09:30:00Z",
  "description": "description",
  "quarter": 1,
  "team": {
    "id": "id",
    "name": "name"
  },
  "teamId": "teamId",
  "owner": {
    "id": "id",
    "name": "name",
    "email": "email",
    "image": "image"
  },
  "ownerUserId": "ownerUserId",
  "score": 1.1
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

titlestringRequired

yearintegerRequired

descriptionstringOptional

periodenumOptional

quarterintegerOptional

priorityenumOptional

The dimension scores are averaged by, so a workspace can see how it did on what mattered most rather than only in aggregate.

visibilityenumOptional

Public objectives are browsable by everyone in the workspace. Private ones are visible to their owner, or to the members of the owning team.

weightdoubleOptional

teamIdstringOptional

ownerUserIdstringOptional

Response

This endpoint returns an object.

idstring

organizationIdstring

titlestring

periodenum

yearinteger

The fiscal year, named by the year its Q1 falls in.

priorityenum

The dimension scores are averaged by, so a workspace can see how it did on what mattered most rather than only in aggregate.

visibilityenum

Public objectives are browsable by everyone in the workspace. Private ones are visible to their owner, or to the members of the owning team.

weightdouble

Relative weight when objectives roll up into an average. One carrying twice the weight moves the average twice as much.

keyResultslist of objects

archivedboolean

createdAtdatetime

updatedAtdatetime

descriptionstringOptional

quarterintegerOptional

1-4 for a quarterly objective, absent for an annual one.

teamobjectOptional

An organizational team such as Eagles or Ravens.

teamIdstringOptional

ownerobjectOptional

A person in a Taktoria organization.

ownerUserIdstringOptional

scoredoubleOptional

The weighted average of its key results’ grades, or absent when none has been scored. Absent rather than 0.0 on purpose: an unscored objective has not failed, and a zero would say it had.

Errors

402

Subscription Required Error

422

Validation Error