Blink Feed API

The Feed API from Blink — 6 operation(s) for feed.

Operations 6

GET /feed/categories Get Feed Event Categories #
GET /feed/event-by-external-id Get Feed Event Id By External Id #
POST /feed/events Send Feed Event #
PUT /feed/events/{event_id} Update Feed Event #
POST /feed/events/{event_id}/archive Archive Feed Event #
POST /feed/events/{event_id}/user/{user_id}/archive Archive Feed Event For User #

Specifications

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/joinblink-com:joinblink-com-feed-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.

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

OpenAPI Specification

joinblink-com-feed-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: blink-api-v2 Feed API
  version: '2'
servers:
- url: https://api.joinblink.com/v2
security:
- sec0: []
tags:
- name: Feed
paths:
  /feed/categories:
    get:
      summary: Get Feed Event Categories
      description: ''
      operationId: get-feed-event-categories
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"code\": \"OK\",\n  \"message\": \"OK\",\n  \"data\": {\n    \"service_id\": \"l-2353940e-ced7-46c4-ac5b-11b6a3129a45\",\n    \"categories\": [\n      {\n        \"category_id\": \"issue_assigned\",\n        \"description\": \"An issue is assigned to you\"\n      }\n    ]\n  },\n  \"request_id\": \"RQ-3501fd43-4a52-4c67-99d2-f139ba6b4065\"\n}"
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: OK
                  message:
                    type: string
                    example: OK
                  data:
                    type: object
                    properties:
                      service_id:
                        type: string
                        example: l-2353940e-ced7-46c4-ac5b-11b6a3129a45
                      categories:
                        type: array
                        items:
                          type: object
                          properties:
                            category_id:
                              type: string
                              example: issue_assigned
                            description:
                              type: string
                              example: An issue is assigned to you
                  request_id:
                    type: string
                    example: RQ-3501fd43-4a52-4c67-99d2-f139ba6b4065
      deprecated: false
      tags:
      - Feed
  /feed/event-by-external-id:
    get:
      summary: Get Feed Event Id By External Id
      description: Get the event_id for a feed event by the external_id it was sent with.
      operationId: get-feed-event-id-by-external-id
      parameters:
      - name: external_id
        in: query
        description: The external_id of the event
        required: true
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"code\": \"OK\",\n  \"message\": \"OK\",\n  \"data\": {\n    \"event_id\": \"e0afa54e-d779-40db-afa5-4ed77930db9f\"\n  },\n  \"request_id\": \"RQ-94b64196-3b52-11e9-8d6e-838ae6e2660e\"\n}"
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: OK
                  message:
                    type: string
                    example: OK
                  data:
                    type: object
                    properties:
                      event_id:
                        type: string
                        example: e0afa54e-d779-40db-afa5-4ed77930db9f
                  request_id:
                    type: string
                    example: RQ-94b64196-3b52-11e9-8d6e-838ae6e2660e
      deprecated: false
      tags:
      - Feed
  /feed/events:
    post:
      summary: Send Feed Event
      description: Allows your integration to send feed events to users in your organisation.
      operationId: send-feed-event
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - category
              - body
              properties:
                category:
                  type: string
                  description: Id for the category of this feed post defined in the admin panel when setting up the integration.
                body:
                  type: string
                  description: The CardKit JSON for the feed event. CardKit JSON that determines how the event will appear in people's feeds. See below for more information.
                user_ids:
                  type: array
                  description: Array of [ids of users](https://blink.readme.io/v2/docs/finding-team-and-user-ids#section-user-ids) who will receive this feed event. At least one user_id or group_id is required for an event to be sent
                  items:
                    type: string
                group_ids:
                  type: array
                  description: Array of [ids of teams](https://blink.readme.io/v2/docs/finding-team-and-user-ids#section-team-ids-group_ids-on-the-api) who will receive this feed event. At least one user_id or group_id is required for an event to be sent.
                  items:
                    type: string
                external_id:
                  type: string
                  description: A unique identifier for this event you can use to retrieve the event_id for the event using the Get Event Id By External Id endpoint.
                notification_title:
                  type: string
                  description: Title of push notification to be send to devices of recipients of this event.
                notification_text:
                  type: string
                  description: Body of push notification to be sent to devices of recipients of this event.
                allow_comments:
                  type: boolean
                  description: Set to true to allow receiving users to comment on the feed event.
                  default: false
                allow_reactions:
                  type: boolean
                  description: Set to true to allow receiving users to react to the feed event.
                  default: false
                organisation_employee_ids:
                  type: object
                  description: Allows sending feed events to users who have the provided employee ids.
                  properties:
                    employee_ids:
                      type: array
                      description: An array of employee ids to send the event to
                      items:
                        type: string
                feature_schedule:
                  type: object
                  description: Feature the post from/until a certain time
                  properties:
                    from:
                      type: string
                      description: Time from when the post should be featured
                      format: date-time
                    to:
                      type: string
                      description: Time until the post should be featured
                      format: date-time
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"code\": \"ACCEPTED\",\n  \"message\": \"Accepted\",\n  \"data\": {\n    \"event_id\": \"501305c6-d43e-4070-9305-c6d43eb07073\"\n  },\n  \"request_id\": \"RQ-73762f3a-3b48-11e9-8d6e-838ae6e2660e\"\n}"
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ACCEPTED
                  message:
                    type: string
                    example: Accepted
                  data:
                    type: object
                    properties:
                      event_id:
                        type: string
                        example: 501305c6-d43e-4070-9305-c6d43eb07073
                  request_id:
                    type: string
                    example: RQ-73762f3a-3b48-11e9-8d6e-838ae6e2660e
      deprecated: false
      tags:
      - Feed
  /feed/events/{event_id}:
    put:
      summary: Update Feed Event
      description: Edit a feed event that has been sent.
      operationId: update-feed-event
      parameters:
      - name: event_id
        in: path
        description: Id of the event to update
        schema:
          type: string
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                body:
                  type: string
                  description: The new CardKit JSON for the feed event.
                  format: json
                notification_title:
                  type: string
                  description: Title of push notification to be send to devices of recipients of this update.
                notification_body:
                  type: string
                  description: Body of push notification to be sent to devices of recipients of this update.
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"code\": \"ACCEPTED\",\n  \"message\": \"Accepted\",\n  \"data\": null,\n  \"request_id\": \"RQ-01278385-3b50-11e9-8310-2f728993ee55\"\n}"
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ACCEPTED
                  message:
                    type: string
                    example: Accepted
                  data: {}
                  request_id:
                    type: string
                    example: RQ-01278385-3b50-11e9-8310-2f728993ee55
      deprecated: false
      tags:
      - Feed
  /feed/events/{event_id}/archive:
    post:
      summary: Archive Feed Event
      description: Dismiss a feed event for all recipients.
      operationId: archive-feed-event
      parameters:
      - name: event_id
        in: path
        description: Id of the event to archive
        schema:
          type: string
        required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"code\": \"OK\",\n  \"message\": \"OK\",\n  \"data\": null,\n  \"request_id\": \"RQ-346cdcf2-3b51-11e9-8310-2f728993ee55\"\n}"
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: OK
                  message:
                    type: string
                    example: OK
                  data: {}
                  request_id:
                    type: string
                    example: RQ-346cdcf2-3b51-11e9-8310-2f728993ee55
      deprecated: false
      tags:
      - Feed
  /feed/events/{event_id}/user/{user_id}/archive:
    post:
      summary: Archive Feed Event For User
      description: Dismiss a feed event for a single user who received the event.
      operationId: archive-feed-event-for-user
      parameters:
      - name: event_id
        in: path
        description: Id of the event to archive
        schema:
          type: string
        required: true
      - name: user_id
        in: path
        description: Id of the user to archive the event for
        schema:
          type: string
        required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"code\": \"OK\",\n  \"message\": \"OK\",\n  \"data\": null,\n  \"request_id\": \"RQ-d6fa2ca7-3b51-11e9-8310-2f728993ee55\"\n}"
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: OK
                  message:
                    type: string
                    example: OK
                  data: {}
                  request_id:
                    type: string
                    example: RQ-d6fa2ca7-3b51-11e9-8310-2f728993ee55
      deprecated: false
      tags:
      - Feed
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: Authorization
      x-bearer-format: bearer
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://developer.joinblink.com/reference
  harvested: '2026-10-28'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developer.joinblink.com/reference/add-user-linked-account.md
  - https://developer.joinblink.com/reference/archive-feed-event-for-user.md
  - https://developer.joinblink.com/reference/archive-feed-event.md
  - https://developer.joinblink.com/reference/delete-user-linked-account.md
  - https://developer.joinblink.com/reference/form-submissions.md
  - https://developer.joinblink.com/reference/get-feed-event-categories.md
  - https://developer.joinblink.com/reference/get-feed-event-id-by-external-id.md
  - https://developer.joinblink.com/reference/get-forms.md
  - https://developer.joinblink.com/reference/get-linked-account.md
  - https://developer.joinblink.com/reference/get-linked-accounts.md
  - https://developer.joinblink.com/reference/get-user-linked-accounts.md
  - https://developer.joinblink.com/reference/get-users.md
  - https://developer.joinblink.com/reference/send-feed-event.md
  - https://developer.joinblink.com/reference/update-feed-event.md
  - https://developer.joinblink.com/reference/update-user-linked-account.md
  merge:
    pages: 15
    deduped: 14
    conflicts_kept_first: 0