List all related epic links for a group

GET

/api/v4/groups/{id}/related_epic_links

• GitLab REST API

Lists all related epic links for a specified group and its subgroups. The user needs to have access to both the source_epic and target_epic to view the related epic link.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

string

ID or URL-encoded path of the group

Example

1

Query Parameters

updated_before

string format: date-time

nullable

Return related epic links updated before the specified time

Example

2016-01-19T09:05:50.355Z

updated_after

string format: date-time

nullable

Return related epic links updated after the specified time

Example

2016-01-19T09:05:50.355Z

created_before

string format: date-time

nullable

Return related epic links created before the specified time

Example

2016-01-19T09:05:50.355Z

created_after

string format: date-time

nullable

Return related epic links created after the specified time

Example

2016-01-19T09:05:50.355Z

page

integer

default: 1 nullable

Current page number

Example

1

per_page

integer

default: 20 nullable

Number of items per page

Example

20

Responses

200

OK

Media type application/json

object

id

integer format: int64

work_item_id

integer

iid

integer

color

string

text_color

string

group_id

integer format: int64

parent_id

integer format: int64

parent_iid

integer

imported

boolean

imported_from

string

title

string

description

string

confidential

boolean

author

object

id

integer format: int64

username

string

public_email

string

name

string

state

string

locked

boolean

avatar_url

string

avatar_path

string

custom_attributes

Array<object>

object

key

string

value

string

web_url

string

start_date

string format: date-time

start_date_is_fixed

boolean

start_date_fixed

string format: date-time

start_date_from_inherited_source

string format: date-time

start_date_from_milestones

string format: date-time

end_date

string format: date-time

due_date

string format: date-time

due_date_is_fixed

boolean

due_date_fixed

string format: date-time

due_date_from_inherited_source

string format: date-time

due_date_from_milestones

string format: date-time

state

string

web_edit_url

string

web_url

string

references

Array<object>

object

reference

string

created_at

string format: date-time

updated_at

string format: date-time

closed_at

string format: date-time

labels

Array<string>

upvotes

integer

downvotes

integer

subscribed

boolean

_links

object

related_epic_link_id

integer format: int64

link_type

string

link_created_at

string format: date-time

link_updated_at

string format: date-time

Example

{
  "id": 123,
  "work_item_id": 123,
  "iid": 123,
  "color": "#1068bf",
  "text_color": "#1068bf",
  "group_id": 17,
  "parent_id": 12,
  "parent_iid": 19,
  "imported": false,
  "imported_from": "github",
  "title": "My Epic",
  "description": "Epic description",
  "confidential": false,
  "author": {
    "id": 1,
    "username": "admin",
    "public_email": "john@example.com",
    "name": "Administrator",
    "state": "active",
    "avatar_url": "https://gravatar.com/avatar/1",
    "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png",
    "custom_attributes": [
      {
        "key": "foo",
        "value": "bar"
      }
    ],
    "web_url": "https://gitlab.example.com/root"
  },
  "start_date": "2022-01-31T15:10:45.080Z",
  "start_date_is_fixed": true,
  "start_date_fixed": "2022-01-31T15:10:45.080Z",
  "start_date_from_inherited_source": "2022-01-31T15:10:45.080Z",
  "start_date_from_milestones": "2022-01-31T15:10:45.080Z",
  "end_date": "2022-01-31T15:10:45.080Z",
  "due_date": "2022-01-31T15:10:45.080Z",
  "due_date_is_fixed": true,
  "due_date_fixed": "2022-01-31T15:10:45.080Z",
  "due_date_from_inherited_source": "2022-01-31T15:10:45.080Z",
  "due_date_from_milestones": "2022-01-31T15:10:45.080Z",
  "state": "opened",
  "web_edit_url": "http://gitlab.example.com/groups/test/-/epics/4/edit",
  "web_url": "http://gitlab.example.com/groups/test/-/epics/4",
  "reference": "&1",
  "created_at": "2022-01-31T15:10:45.080Z",
  "updated_at": "2022-01-31T15:10:45.080Z",
  "closed_at": "2022-01-31T15:10:45.080Z",
  "upvotes": 4,
  "downvotes": 3,
  "subscribed": true,
  "related_epic_link_id": 1,
  "link_type": "relates_to",
  "link_created_at": "2022-01-31T15:10:45.080Z",
  "link_updated_at": "2022-01-31T15:10:45.080Z"
}

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found