Impact

Impact Tasks API

The Tasks API from Impact — 4 operation(s) for tasks.

Documentation GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /Advertisers/{AccountSID}/Programs/{ProgramId}/Tasks List a program's tasks as a brand · List All Tasks #

Ask an LLM

“What open tasks exist on my program?”

“Can a brand filter program tasks by type or last update?”

Tell an agent

List tasks on program {program} in brand account {sid}.

Show program {program} tasks of type {type}.

GET /Advertisers/{AccountSID}/Programs/{ProgramId}/Tasks/{TaskId} Get a program task as a brand · Get Task Details #

Ask an LLM

“What's in a specific task on my brand's program?”

“Can a brand look up a program task by ID?”

Tell an agent

Get task {task} on program {program} in account {sid}.

Show brand program {program} task {task}.

GET /Mediapartners/{AccountSID}/Tasks List tasks assigned to a partner · List All Tasks #

Ask an LLM

“What tasks have brands assigned to me as a partner?”

“Can I see partner tasks created after a certain date?”

Tell an agent

List tasks assigned to partner account {sid}.

Show my partner tasks created after {after}.

GET /Mediapartners/{AccountSID}/Tasks/{TaskId} Get a task assigned to a partner · Get Task Details #

Ask an LLM

“What does a task assigned to my partner account ask me to do?”

“Where do I see details of one assigned task?”

Tell an agent

Get assigned task {task} on partner account {sid}.

Show the partner task {task} I was given.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/impact:impact-tasks-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Impact Tasks API
  version: '1.0'
  description: 'Operations tagged Tasks across 2 of this provider''s published API definitions: impact-brand-tasks-v14-openapi.yml, impact-partner-tasks-v16-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.impact.com
tags:
- name: Tasks
paths:
  /Advertisers/{AccountSID}/Programs/{ProgramId}/Tasks:
    get:
      summary: List All Tasks
      description: Returns a list of existing, non-archived tasks for a specific program.
      operationId: listTasks
      tags:
      - Tasks
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ProgramId
        in: path
        required: true
        description: The ID of the program to retrieve tasks from.
        schema:
          type: integer
      - name: Type
        in: query
        description: Filter tasks by one or more comma-separated task types. For compliance violations, use COMPLIANCE. Values match the Type field in the Task response.
        schema:
          type: string
          example: COMPLIANCE
      - name: SubtypeName
        in: query
        description: Filter tasks by one or more comma-separated subtype names. Requires the Type parameter. For compliance violations, common values are Search, Promo, Social, and Content. Passing an unrecognized subtype returns a validation error.
        schema:
          type: string
          example: Content
      - name: DateCreatedAfter
        in: query
        description: Only return tasks created on or after this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: DateCreatedBefore
        in: query
        description: Only return tasks created on or before this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: DateLastUpdatedBefore
        in: query
        description: Only return tasks updated before this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: DateLastUpdatedAfter
        in: query
        description: Only return tasks updated after this date (ISO 8601).
        schema:
          type: string
          format: date-time
      responses:
        '200':
          description: A paginated list of task objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Tasks:
                    type: array
                    description: The list of task objects.
                    items:
                      $ref: '#/components/schemas/Task'
    servers:
    - url: https://api.impact.com
  /Advertisers/{AccountSID}/Programs/{ProgramId}/Tasks/{TaskId}:
    get:
      summary: Get Task Details
      description: Retrieves the details of an existing task by its unique ID.
      operationId: getTaskById
      tags:
      - Tasks
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ProgramId
        in: path
        required: true
        schema:
          type: integer
      - name: TaskId
        in: path
        required: true
        description: The unique identifier for the task.
        schema:
          type: integer
      responses:
        '200':
          description: A single task object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Task'
    servers:
    - url: https://api.impact.com
  /Mediapartners/{AccountSID}/Tasks:
    get:
      operationId: getMediapartnersByAccountSIDTasks
      tags:
      - Tasks
      summary: List All Tasks
      description: Returns a list of existing, non-archived tasks assigned to your partner account.
      parameters:
      - name: AccountSID
        in: path
        required: true
        description: Unique identifier for the partner account.
        schema:
          type: string
      - name: Type
        in: query
        required: false
        description: Filter tasks by one or more comma-separated task types. For compliance violations, use COMPLIANCE. Values match the Type field in the Task response.
        schema:
          type: string
          example: COMPLIANCE
      - name: SubtypeName
        in: query
        required: false
        description: Filter tasks by one or more comma-separated subtype names. Requires the Type parameter. For compliance violations, common values are Search, Promo, Social, and Content. Passing an unrecognized subtype returns a validation error.
        schema:
          type: string
          example: Content
      - name: DateCreatedAfter
        in: query
        required: false
        description: Only return tasks created on or after this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: DateCreatedBefore
        in: query
        required: false
        description: Only return tasks created on or before this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: DateLastUpdatedBefore
        in: query
        required: false
        description: Only return tasks updated before this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: DateLastUpdatedAfter
        in: query
        required: false
        description: Only return tasks updated after this date (ISO 8601).
        schema:
          type: string
          format: date-time
      responses:
        '200':
          description: A list of task objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Tasks:
                    type: array
                    description: The list of task objects.
                    items:
                      $ref: '#/components/schemas/Task_2'
      x-codeSamples:
      - lang: Shell
        label: curl
        source: "curl -L \\\n  --url 'https://api.impact.com/Mediapartners/{AccountSID}/Tasks' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Accept: */*'"
      security:
      - basicAuth: []
      x-operation-id-source: normalized
      x-operation-id-original: listTasks
    servers:
    - url: https://api.impact.com
      description: Production server
  /Mediapartners/{AccountSID}/Tasks/{TaskId}:
    get:
      operationId: getMediapartnersByAccountSIDTasksByTaskId
      tags:
      - Tasks
      summary: Get Task Details
      description: Retrieves the details of an existing task assigned to your partner account by its unique ID.
      parameters:
      - name: AccountSID
        in: path
        required: true
        description: Unique identifier for the partner account.
        schema:
          type: string
      - name: TaskId
        in: path
        required: true
        description: The unique identifier for the task.
        schema:
          type: integer
      responses:
        '200':
          description: A single task object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Task_2'
      x-codeSamples:
      - lang: Shell
        label: curl
        source: "curl -L \\\n  --url 'https://api.impact.com/Mediapartners/{AccountSID}/Tasks/{TaskId}' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Accept: */*'"
      security:
      - basicAuth: []
      x-operation-id-source: normalized
      x-operation-id-original: getTaskById
    servers:
    - url: https://api.impact.com
      description: Production server
components:
  schemas:
    Attachment:
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier for the attachment.
          example: task_1223456_988957a0-e0ed-4f16-984b-f5a9259e6be7
        Filename:
          type: string
          description: Original filename of the attachment.
          example: acme_reward_card_details.pdf
        Location:
          type: string
          format: uri
          description: URL to download the attachment.
          example: https://cdn.example.com/task_123456_988957a0-e0ed-4f16-984b-f5a9259e6be7.pdf
    User:
      type: object
      properties:
        Username:
          type: string
          description: The user's username.
          example: Wile E. Coyote
        EmailAddress:
          type: string
          format: email
          description: The user's email address.
          example: wilecoyote@example.com
    TaskReference:
      type: object
      properties:
        PartnerId:
          type: integer
          description: Unique identifier of the partner this task is about.
          example: 2552842
        PartnerValue1:
          type: string
          description: Custom partner tracking value 1.
          example: vip
        PartnerValue2:
          type: string
          description: Custom partner tracking value 2.
          example: north-america
        PartnerValue3:
          type: string
          description: Custom partner tracking value 3.
          example: tennis
    Comment:
      type: object
      properties:
        Id:
          type: integer
          description: Unique identifier for the comment.
          example: 98765
        Comment:
          type: string
          description: The comment text.
          example: I've updated our home page with the latest ads, see attached screenshot.
        Commenter:
          type: string
          description: Name of the user who posted the comment.
          example: Wile E. Coyote
        Attachments:
          type: array
          description: Details about each attachment on the comment.
          items:
            $ref: '#/components/schemas/Attachment'
    Task:
      type: object
      properties:
        Id:
          type: string
          example: '3562529'
        Reference:
          $ref: '#/components/schemas/TaskReference'
          description: Identifies the partner by ID and custom values.
        Details:
          $ref: '#/components/schemas/TaskDetails'
          description: Title of the request.
        Attachments:
          type: array
          items:
            $ref: '#/components/schemas/Attachment'
          description: Details about each attachment.
        DueDate:
          type: string
          format: date-time
          example: 2021-08-31T04:00:00.000+0000
          description: Date and time at which the task is due. Displayed in ISO 8601 format.
        AssigneeUser:
          $ref: '#/components/schemas/User'
          description: Name of the user of the partner account that the task is assigned to.
        AssigneeAccount:
          type: string
          example: Acme Partners
          description: Name of the partner account that the task is assigned to.
        TotalActions:
          type: integer
          description: Total number of actions that have been recorded for this task.
          example: 0
        Actions:
          type: array
          description: Describes actions that have occurred on this task.
          items: {}
        TotalComments:
          type: integer
          description: Total number of comments that have been recorded for this task.
          example: 1
        Comments:
          type: array
          items:
            $ref: '#/components/schemas/Comment'
          description: Details about each comment on this task.
        DateCreated:
          type: string
          format: date-time
          description: The date and time the task was created.
          example: 2021-08-18T16:47:21.000+0000
        DateLastUpdated:
          type: string
          format: date-time
          example: 2021-08-18T22:45:42.000+0000
          description: The date and time the task was last updated.
        CreatedBy:
          $ref: '#/components/schemas/User'
          description: Name of the user that created the task.
        LastUpdatedBy:
          $ref: '#/components/schemas/User'
          description: Name of the user that last updated the task.
    TaskDetails:
      type: object
      properties:
        Summary:
          type: string
          example: Acme Rewards Card Update
        Description:
          type: string
          example: The Acme Rewards Card APR has changed, please update your ads to reflect this new value.
        Urgent:
          type: boolean
          example: true
        State:
          type: string
          enum:
          - NEW
          - INPROGRESS
          - DUPLICATE
          - INVALID
          - BLOCKED
          - COMPLETED
          - APPROVED
          example: INPROGRESS
        Type:
          type: string
          enum:
          - COMPLIANCE
          - TECHNICAL
          - GENERAL
          - CREATIVE
          - FINANCE
          - CONTRACTS
          - ANALYTICS
          - MONITORING
          example: COMPLIANCE
        SubtypeId:
          type: string
          nullable: true
          example: '275'
        SubtypeName:
          type: string
          nullable: true
          example: Content
        ResolutionId:
          type: string
          nullable: true
          example: ''
        ResolutionName:
          type: string
          nullable: true
          example: ''
    Task_2:
      type: object
      properties:
        Id:
          type: string
          example: '3562529'
        Reference:
          $ref: '#/components/schemas/TaskReference'
          description: Identifies the partner by ID and custom values.
        Details:
          $ref: '#/components/schemas/TaskDetails_2'
          description: Details of the task, including its summary, description, urgency, state, type, subtype, and resolution.
        Attachments:
          type: array
          items:
            $ref: '#/components/schemas/Attachment'
          description: Details about each attachment.
        DueDate:
          type: string
          format: date-time
          example: 2021-08-31T04:00:00.000+0000
          description: Date and time at which the task is due. Displayed in ISO 8601 format.
        AssigneeUser:
          $ref: '#/components/schemas/User'
          description: Name of the user of the partner account that the task is assigned to.
        AssigneeAccount:
          type: string
          example: Acme Partners
          description: Name of the partner account that the task is assigned to.
        TotalActions:
          type: integer
          description: Total number of actions that have been recorded for this task.
          example: 0
        Actions:
          type: array
          description: Describes actions that have occurred on this task.
          items: {}
        TotalComments:
          type: integer
          description: Total number of comments that have been recorded for this task.
          example: 1
        Comments:
          type: array
          items:
            $ref: '#/components/schemas/Comment'
          description: Details about each comment on this task.
        DateCreated:
          type: string
          format: date-time
          description: The date and time the task was created.
          example: 2021-08-18T16:47:21.000+0000
        DateLastUpdated:
          type: string
          format: date-time
          example: 2021-08-18T22:45:42.000+0000
          description: The date and time the task was last updated.
        CreatedBy:
          $ref: '#/components/schemas/User'
          description: Name of the user that created the task.
        LastUpdatedBy:
          $ref: '#/components/schemas/User'
          description: Name of the user that last updated the task.
    TaskDetails_2:
      type: object
      properties:
        Summary:
          type: string
          example: Acme Rewards Card Update
        Description:
          type: string
          example: The Acme Rewards Card APR has changed, please update your ads to reflect this new value.
        Urgent:
          type: boolean
          example: true
        State:
          type: string
          enum:
          - NEW
          - INPROGRESS
          - DUPLICATE
          - INVALID
          - BLOCKED
          - COMPLETED
          - APPROVED
          example: INPROGRESS
        Type:
          type: string
          enum:
          - COMPLIANCE
          - TECHNICAL
          - GENERAL
          - CREATIVE
          - FINANCE
          - CONTRACTS
          - ANALYTICS
          - MONITORING
          example: COMPLIANCE
        SubtypeId:
          type:
          - string
          - 'null'
          example: '275'
        SubtypeName:
          type: string
          nullable: true
          example: Content
        ResolutionId:
          type: string
          nullable: true
          example: ''
        ResolutionName:
          type: string
          nullable: true
          example: ''
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Use your AccountSID as the username and AuthToken as the password.
x-refined-from:
- impact-brand-tasks-v14-openapi.yml
- impact-partner-tasks-v16-openapi.yml

Impact Tasks API

Operations 4

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification