Get the article at a public URL, in the staff view
The article at a public URL, seen by staff.
/v1/help-centre/articles/by-slug/{slug}Viewer- Operation id
- get_by_slug
- Access
- Any workspace role can call this.
/v1/help-centre/articles/by-slug/{slug}The article at a public URL, seen by staff.
Use this when you have the URL a visitor is looking at and need the record behind it. Unlike the public route, this resolves the slug exactly: there is no redirect and no fallback to another locale, so a slug that has since changed is a 404 here while the public route still reaches the article.
The response is the full staff view, including drafts and internal articles.
Registered before the id route so by-slug is never read as a translation
id.
Tenancy: the request is scoped to one workspace, and the credential presented is what selects it. A caller with no membership in that workspace is refused with 404, which is indistinguishable from a workspace that does not exist.
Authorisation: any workspace role, including viewer. Reads are open to every member.
Access: Authorization: Bearer carrying either a realm access token or an API key. A key must hold the help-centre-staff:read scope, and the workspace role of the person who owns it must meet the floor above.
A realm-issued access token, presented as Authorization: Bearer <token>. It acts as the person who signed in, and every operation resolves their workspace role live from the membership record.
In: header
Path Parameters
length <= 200Query Parameters
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/help-centre/articles/by-slug/string"{ "article_id": "string", "translation_id": "string", "locale": "string", "title": "string", "slug": "string", "excerpt": "string", "container_path": "string", "url": "string", "position": 0, "promoted": true, "breadcrumbs": [ { "name": "string", "path": "string", "url": "string" } ], "updated_at": "2019-08-24T14:15:22Z", "published_at": "2019-08-24T14:15:22Z", "vote_count": 0, "vote_sum": 0, "visibility": "string", "editorial_state": "string", "source_visibility_raw": {}, "permission_group_id": "string", "user_segment_ids": [ "string" ], "outdated": true, "outdated_locales": [ "string" ], "missing_at_source_at": "2019-08-24T14:15:22Z", "locally_edited_at": "2019-08-24T14:15:22Z", "has_conflict": true, "conflict_seen_at": "2019-08-24T14:15:22Z", "body_html": "string", "body_markdown": "string", "body_format": "string", "sanitizer_version": "string", "sanitize_report": {}, "link_report": {}, "asset_report": {}, "source_status_raw": "string", "canonical_url": "string", "alternates": [ { "locale": "string", "url": "string" } ], "author_label": "string", "labels": [ "string" ], "source_url": "string", "source_created_at": "2019-08-24T14:15:22Z", "source_updated_at": "2019-08-24T14:15:22Z", "noindex": true}