Get Task - Topo

GET

/

v1

/

tasks

/

{task_id}

Get Task

curl --request GET \
  --url https://api.topo.io/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.topo.io/v1/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assignee_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reopened_at": "2023-11-07T05:31:56Z",
  "reopen_reason": "REMINDER_RULE",
  "skipped_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "title": "<string>",
  "due_date": "2023-12-25",
  "contact": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "linkedin_url": "<string>",
    "job_title": "<string>",
    "company_name": "<string>",
    "company_domain": "<string>"
  },
  "assignee": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "name": "<string>"
  },
  "sequence_template": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "snoozed_until": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Bearer API key issued from Settings → Developers.

Path Parameters

task_id

string<uuid>

required

ID of the task.

Response

200 - application/json

Successful Response

id

string<uuid>

required

Unique identifier.

organization_id

string<uuid>

required

Workspace this task belongs to.

type

enum<string>

required

What kind of task this is.

Available options:

EMAIL_REPLY,

LINKEDIN_REPLY,

NEW_LEAD_REVIEW,

CALL,

PLAYBOOK_APPROVAL,

TODO

priority

enum<string>

required

Task priority bucket.

Available options:

HOT,

TODAY,

EXTRA

status

enum<string>

required

Current lifecycle state.

Available options:

PENDING,

IN_PROGRESS,

COMPLETED,

SKIPPED

sequence_id

string<uuid> | null

required

Sequence run this task was projected from, if any.

assignee_user_id

string<uuid> | null

required

User the task is assigned to, if any.

disposition

enum<string> | null

required

Outcome for call tasks once executed.

Available options:

ANSWERED,

VOICEMAIL_LEFT,

NO_ANSWER,

INTERESTED,

NOT_INTERESTED,

WRONG_NUMBER

reopened_at

string<date-time> | null

required

When the task was last reopened, if ever.

reopen_reason

enum<string> | null

required

Why the task was reopened, if applicable.

Available options:

REMINDER_RULE

skipped_at

string<date-time> | null

required

When the task was skipped, if applicable.

completed_at

string<date-time> | null

required

When the task was completed, if applicable.

created_at

string<date-time>

required

When the task was created.

updated_at

string<date-time>

required

When the task last changed.

title

string | null

Task title for standalone tasks.

due_date

string<date> | null

Due date for standalone tasks.

contact

PublicContactSummary · object | null

Summary of the contact linked to this task.

Hide child attributes

contact.id

string<uuid>

required

Unique identifier of the contact.

contact.first_name

string | null

First name.

contact.last_name

string | null

Last name.

contact.email

string | null

Email.

contact.linkedin_url

string | null

LinkedIn profile URL.

contact.job_title

string | null

Job title.

contact.company_name

string | null

Employer name.

contact.company_domain

string | null

Employer's primary domain.

assignee

PublicUserSummary · object | null

Summary of the user this task is assigned to.

Hide child attributes

assignee.id

string<uuid>

required

Unique identifier of the user.

assignee.email

string

required

Email address.

assignee.name

string | null

Display name.

sequence_template

PublicSequenceTemplateSummary · object | null

Summary of the sequence template for sequence-derived tasks.

Hide child attributes

sequence_template.id

string<uuid>

required

Unique identifier of the sequence template.

sequence_template.name

string

required

Template name.

snoozed_until

string<date-time> | null

When the task is snoozed until, if deferred.

Get Task

curl --request GET \
  --url https://api.topo.io/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.topo.io/v1/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assignee_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reopened_at": "2023-11-07T05:31:56Z",
  "reopen_reason": "REMINDER_RULE",
  "skipped_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "title": "<string>",
  "due_date": "2023-12-25",
  "contact": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "linkedin_url": "<string>",
    "job_title": "<string>",
    "company_name": "<string>",
    "company_domain": "<string>"
  },
  "assignee": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "name": "<string>"
  },
  "sequence_template": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "snoozed_until": "2023-11-07T05:31:56Z"
}