# Fiche connecteur Slab
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Slab
URL : https://get-bruno.com/features/connectors/slab
Référence texte : https://get-bruno.com/features/connectors/slab/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Organisation du travail
Description : Slab est un logiciel de base de connaissances et de wiki pour rechercher, lire, créer et mettre à jour des posts, ainsi que pour associer ou retirer des sujets et consulter les utilisateurs de l’organisation.
Authentification : API key
Présentation : Slab est un logiciel de base de connaissances et de wiki pour rechercher, lire, créer et mettre à jour des posts, ainsi que pour associer ou retirer des sujets et consulter les utilisateurs de l’organisation.
Usage : Retrouver un post et lire son contenu
Exemple de demande : Je veux retrouver le compte-rendu « Atelier Martin - réunion de suivi » et lire son contenu complet.
Résultat attendu : Tu retrouves les posts correspondants avec Search Posts, puis tu lis le post choisi avec Get Posts pour obtenir son contenu et ses métadonnées.
À préciser : Un titre ou un mot-clé pour lancer la recherche, par exemple « Atelier Martin ». ; L’identifiant du post à lire, obtenu dans les résultats de recherche.
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/slab/actions/search-posts ; https://pipedream.com/apps/slab/actions/get-posts
Usage : Créer un brouillon de guide interne
Exemple de demande : Je veux créer un brouillon intitulé « Guide d’accueil équipe support » et le laisser non publié.
Résultat attendu : Un nouveau post est créé. Si tu fournis du contenu, il est ajouté après la création. Le post reste en brouillon si Published est défini à false.
À préciser : Le titre du post. ; L’identifiant du sujet à associer, obtenu avec Lister les sujets, si tu veux classer le post dès la création. ; Le texte à ajouter au corps, si le contenu doit être saisi à la création.
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/slab/actions/list-topics ; https://pipedream.com/apps/slab/actions/create-post
Usage : Classer un post dans un sujet existant
Exemple de demande : Je veux ajouter le sujet « Engineering » au post « Q3 Onboarding Guide ».
Résultat attendu : Le post est associé au sujet demandé et l’action renvoie le sujet lié.
À préciser : L’identifiant du post à modifier, obtenu par une recherche préalable. ; L’identifiant du sujet à associer, obtenu avec Lister les sujets.
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/slab/actions/search-posts ; https://pipedream.com/apps/slab/actions/list-topics ; https://pipedream.com/apps/slab/actions/add-topic-to-post
Limites propres au service : Search Posts peut aussi lister tous les posts quand Query est vide; List Posts est redondante et ne propose qu’une pagination avant. Les sujets et les utilisateurs doivent d’abord être listés pour récupérer leurs identifiants. Update Post ne modifie ni le titre ni le contenu; Update Post Content utilise un delta Quill encodé en JSON. Le titre affiché dépend de la première ligne du contenu, et une modification de contenu doit être recalculée à partir de l’état courant du post.
Vocabulaire français : Ajouter un sujet à un post — Associe un sujet à un post et renvoie le sujet lié. (https://pipedream.com/apps/slab/actions/add-topic-to-post)
Vocabulaire français : Créer un post — Crée un nouveau post, puis ajoute le contenu après création si du texte est fourni. (https://pipedream.com/apps/slab/actions/create-post)
Vocabulaire français : Obtenir des posts — Récupère un ou plusieurs posts à partir de leurs identifiants, avec contenu et métadonnées. (https://pipedream.com/apps/slab/actions/get-posts)
Vocabulaire français : Lister les posts — Retourne tous les posts de l’organisation avec pagination avant uniquement. (https://pipedream.com/apps/slab/actions/list-posts)
Vocabulaire français : Lister les sujets — Retourne les sujets de l’organisation pour obtenir les identifiants à utiliser dans les autres actions. (https://pipedream.com/apps/slab/actions/list-topics)
Vocabulaire français : Lister les utilisateurs — Retourne les utilisateurs de l’organisation avec leur identifiant, leur nom et leur adresse de courriel. (https://pipedream.com/apps/slab/actions/list-users)
Vocabulaire français : Retirer un sujet d’un post — Retire l’association entre un sujet et un post sans supprimer ni le post ni le sujet. (https://pipedream.com/apps/slab/actions/remove-topic-from-post)
Vocabulaire français : Rechercher des posts — Recherche ou liste les posts de l’organisation et renvoie leurs identifiants. (https://pipedream.com/apps/slab/actions/search-posts)
Vocabulaire français : Mettre à jour un post — Modifie les métadonnées et les accès d’un post, sans changer son titre ni son contenu. (https://pipedream.com/apps/slab/actions/update-post)
Vocabulaire français : Mettre à jour le contenu d’un post — Remplace ou édite le corps d’un post à l’aide d’un delta Quill transmis en JSON encodé. (https://pipedream.com/apps/slab/actions/update-post-content)
- action : Add Topic To Post — Associate a topic with a post via the addTopicToPost GraphQL mutation, returning the topic. Run Search Posts to obtain the post ID and List Topics to obtain the topic ID before calling. Example: postId abc123 , topicId abc12def returns {"id":"abc12def","name":"Engineering"} . See the documentation. (https://pipedream.com/apps/slab/actions/add-topic-to-post)
- action : Create Post — Create a new post in Slab via the createPost GraphQL mutation, returning the full post object (e.g. {"id":"abc123","title":"Q3 Onboarding Guide","topics":[{"id":"abc12def","name":"Engineering"}]} ). If Content is provided, the body is appended after creation via the updatePostContent mutation (the Slab schema does not accept content at creation time). Slab derives the displayed title from the first line of the post's content, so the appended text is inserted after the existing title line rather than replacing it — this preserves Title instead of overwriting it. NOTE: the returned content field reflects the pre-append snapshot (title line only) even though the append is applied — treat a non-error response as confirmation, not the returned content . New posts are published by default (set Published to false to leave it as an unpublished draft) — unpublished posts do not appear in Search Posts / List Posts results. Run List Topics to obtain a Topic ID to pass at creation. See the documentation. (https://pipedream.com/apps/slab/actions/create-post)
- action : Get Posts — Get one or more Slab posts by their IDs, returning full post objects including content, owner, and associated topics. Use Search Posts first to discover post IDs; this action does not list or search. Accepts up to 100 IDs per call. Example: postIds ["abc123"] returns [{"id": "abc123", "title": "Engineering Onboarding Guide", "owner": {"id": "u1", "name": "Alice"}, "topics": [{"id": "abc12def", "name": "Engineering"}], "content": "..."}] . Pass Fields (e.g. ["id","title","owner"] ) to trim large fields like content from each result when only metadata is needed. See the documentation. (https://pipedream.com/apps/slab/actions/get-posts)
- action : List Posts — List all posts in the Slab organization (no filter). This action is superseded by Search Posts , which accepts an optional Query string and can list all posts when Query is empty. Prefer Search Posts for new workflows. Returns { posts, pageInfo } — posts is an array of post objects (e.g. {"id": "abc123", "title": "Engineering Onboarding Guide", "owner": {"id": "u1", "name": "Alice"}, "topics": [{"id": "abc12def", "name": "Engineering"}]} ). Only forward pagination is supported: when pageInfo.hasNextPage is true , pass pageInfo.endCursor as After to retrieve the next page. Pass Fields (e.g. ["id","title","owner"] ) to trim large fields like content from each post when only metadata is needed. See the documentation. (https://pipedream.com/apps/slab/actions/list-posts)
- action : List Topics — List all topics in the Slab organization via the organization { topics } GraphQL query, returning an array of topic objects with id and name (e.g. [{"id":"abc12def","name":"Engineering"}] ). This is the picker action agents should call to obtain topic IDs for Create Post , Add Topic To Post , and Remove Topic From Post . There is no root topics-listing query, so this reads the organization's topics field. See the documentation. (https://pipedream.com/apps/slab/actions/list-topics)
- action : List Users — List all users in the Slab organization via the organization { users } GraphQL query, returning an array of user objects with id , name , and email (e.g. [{"id":"u1","name":"Alice","email":"alice@example.com"}] ). This is the picker action agents should call to obtain a user ID for Update Post 's Owner ID. See the documentation. (https://pipedream.com/apps/slab/actions/list-users)
- action : Remove Topic From Post — Disassociate a topic from a post via the removeTopicFromPost GraphQL mutation, returning the topic. This only removes the association (reversible with Add Topic To Post ); it does not delete the post or the topic. Run Search Posts for the post ID and List Topics for the topic ID before calling. Example: postId abc123 , topicId abc12def returns {"id":"abc12def","name":"Engineering"} . See the documentation. (https://pipedream.com/apps/slab/actions/remove-topic-from-post)
- action : Search Posts — List or search posts in the Slab organization via the GraphQL search endpoint. Leave Query empty to list all posts; provide a Query string to full-text search. This is the picker action agents should call to obtain post IDs for Get Posts , Update Post , Add Topic To Post , and Remove Topic From Post . Returns { posts, pageInfo } — posts is an array of post objects (e.g. {"id": "abc123", "title": "Engineering Onboarding Guide", "owner": {"id": "u1", "name": "Alice"}, "topics": [{"id": "abc12def", "name": "Engineering"}]} ). Only forward pagination is supported: when pageInfo.hasNextPage is true , pass pageInfo.endCursor as After to retrieve the next page. Pass Fields (e.g. ["id","title","owner"] ) to trim large fields like content from each post when only metadata is needed. See the documentation. (https://pipedream.com/apps/slab/actions/search-posts)
- action : Update Post — Update a post's metadata and access settings via the updatePost GraphQL mutation, returning the updated post object. Manages link access (sharing), owner, archived/published state, and banner. NOTE: this mutation does NOT change title or content; use Update Post Content for the body (there is no title-update field in the schema). Run Search Posts first to obtain the post ID. Example: postId abc123 , archived true returns {"id":"abc123","title":"Q3 Onboarding Guide","archivedAt":"2026-01-01T00:00:00Z","linkAccess":"INTERNAL"} . See the documentation. (https://pipedream.com/apps/slab/actions/update-post)
- action : Update Post Content — Replace or edit a post's body via the updatePostContent GraphQL mutation. Content must be supplied as a Quill delta (see https://quilljs.com/docs/delta/) wrapped in an {"ops":[...]} object, passed as a JSON string — the API rejects a native/unwrapped delta object at the GraphQL layer. IMPORTANT: Slab derives the post's displayed title from the first line of its content — there is no independent title field after creation. An op with {"retain":0} (or no leading retain) inserts at the very start WITHOUT deleting anything — it pushes the existing content later in the document, so it can change what displays as the title without removing the old title text (which still exists, just no longer on the first line). To actually replace the title, delete the existing title's range — {"delete":N} where N is the old title line's length — then insert the replacement. To append body text while preserving the title, first read the post's current content (via Search Posts or Get Posts ) and lead with a retain count covering the existing title line's length. This is a distinct endpoint from Update Post (which handles metadata/access only, and cannot change title). Run Search Posts first to obtain the post ID. Example (append after a 20-character title line): postId abc123 , delta {"ops":[{"retain":20},{"insert":"Additional body text.\n"}]} — a non-error response confirms the edit was accepted. CRITICAL: this mutation applies your delta positionally against whatever the post's content actually is at the moment the call runs — there is no version check, and the response reflects the pre-edit snapshot, not the result. Always re-read the post's current content ( Search Posts or Get Posts ) immediately before computing a delta, and if you need to make a second edit to the same post, re-read again first — never compute a new delta from an earlier read or from this action's own response. Offsets computed against a stale snapshot land in the wrong place and silently corrupt the document instead of erroring; they do not queue safely. See the documentation. (https://pipedream.com/apps/slab/actions/update-post-content)