GET : Job alerts

This endpoint lets you retrieve every job alert for a media.

This endpoint requires:

• media_admin or brand_admin roles

• r_job_alerts scope

List Job alerts

GET https://api-piloty.fr/job_alerts

Query Parameters

Name	Type	Description
media-public-id*	String	Public id of the media
limit	Number	Amount of items per page (default=500)
next-page	String	Cursor to definition. See Pagination

Response examples

200: OK success

Request

https://api-piloty.fr/job_alerts?limit=10&media-public-id=[authorized_media]

Response

{
    "total": 121,
    "totalPages": 4,
    "next-page":"CIMjGgIQABoJKaZ3asmVAQAAIho6GDY3ZTFhNDc4ZTc0ODNjMWI0ZDUyOWE0Yg=="
    "data": [
        {
             "name": "ACME Media - Offres de jobs",
              "user_candidate": {
                "fullname": "John Doe",
                "email": "[e-mail]"
            },
            "job_search_query_url": "public_id=acme_media&index=more_90&sectors=630f96baa4ef90ff2a51ee34&certifications=668febe473ca0bfe6860b9eb&size=62cc627cf40fc5d45819d8f8",
            "job_search_query": "{\"public_id\":\"acme_media\",\"searchJob\":\"\",\"publishedAfter\":\"\",\"sectors\":[\"630f96baa4ef90ff2a51ee34\"]}",
            "createdAt": "2024-09-17T14:39:25.05Z",
        },
        {...}
    ]
}

401: Unauthorized unauthorized limitation

Request

https://api-piloty.fr/job_alerts?media-public-id=[unauthorized_media]

Response

{
    "status": 401,
    "error": "unauthorized-limitation"
}

400: Bad request missing media-public-id

Request

https://api-piloty.fr/job_alerts

Response

{
    "status": 400,
    "error": "missing-media-public-id"
}

Request example

curl    -X GET -G "https://api-piloty.fr/job_alerts?media-public-id=acme_media \
        -H "Authorization: Bearer PILOTY_TOKEN"