---
title: "Add the specified Link to the related links for the news story"
method: POST
path: "/batch/{batch_id}/news/{id}/link"
tags: ["news", "links"]
---

# Add the specified Link to the related links for the news story

`POST /batch/{batch_id}/news/{id}/link`

## Request

- Base URL: `https://submitapi.dvidshub.net`
- URL: `https://submitapi.dvidshub.net/batch/{batch_id}/news/{id}/link`
- Auth: OAuth 2
  - Authorization code: `https://api.dvidshub.net/auth/authorize`
  - Token URL: `https://api.dvidshub.net/auth/access_token` scopes: `basic`, `email`, `upload`
- TypeScript: <https://skmtc.dev/dvidshub/apis/dvids-content-submission-api/docs/batch/:batch_id/news/:id/link/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `data` object, required: Represents a URL with a descriptive title
    - `id` string, required
    - `type` 'link', required
    - `attributes` object, required
      - `title` string: Descriptive text for this link
      - `url` string, url: The URL must use HTTPS protocol and have a TLD that ends in .mil, .gov, or dvidshub.net

## Response `200`

The created Link object

- object
  - `data` object, required: Represents a URL with a descriptive title
    - `id` string, required
    - `type` 'link', required
    - `attributes` object, required
      - `title` string: Descriptive text for this link
      - `url` string, url: The URL must use HTTPS protocol and have a TLD that ends in .mil, .gov, or dvidshub.net

## Other responses

- `400`: The request payload is not correctly formed.
- `403`: Access is denied to the requested resource.
- `404`: The object identified by path parameters does not exist.

---

[API](https://skmtc.dev/dvidshub/apis/dvids-content-submission-api.md) - [All operations](https://skmtc.dev/dvidshub/apis/dvids-content-submission-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dvidshub/apis/dvids-content-submission-api/revisions/921b385ab6b9?raw)