summaryrefslogtreecommitdiff
path: root/doc/api/project_snippets.md
diff options
context:
space:
mode:
authorRobert Schilling <rschilling@student.tugraz.at>2015-05-03 14:56:00 +0200
committerRobert Schilling <rschilling@student.tugraz.at>2015-05-03 14:56:00 +0200
commit78aadc933627c1e990fb00666ade07d18d4caf11 (patch)
treee2cf7dfb6ebb5bfca2cfdeaa58cb7427d9218fa6 /doc/api/project_snippets.md
parent76f7bdccc09fe1290cee330480c1a2640e3b20d5 (diff)
downloadgitlab-ce-78aadc933627c1e990fb00666ade07d18d4caf11.tar.gz
Add snippet visibilty as parameter to API doc, closes #1562
Diffstat (limited to 'doc/api/project_snippets.md')
-rw-r--r--doc/api/project_snippets.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/api/project_snippets.md b/doc/api/project_snippets.md
index 50e134847c0..a7acf37b5bc 100644
--- a/doc/api/project_snippets.md
+++ b/doc/api/project_snippets.md
@@ -1,5 +1,18 @@
# Project snippets
+### Snippet visibility level
+
+Snippets in GitLab can be either private, internal or public.
+You can set it with the `visibility_level` field in the snippet.
+
+Constants for snippet visibility levels are:
+
+| Visibility | visibility_level | Description |
+| ---------- | ---------------- | ----------- |
+| Private | `0` | The snippet is visible only the snippet creator |
+| Internal | `10` | The snippet is visible for any logged in user |
+| Public | `20` | The snippet can be accessed without any authentication |
+
## List snippets
Get a list of project snippets.
@@ -58,6 +71,7 @@ Parameters:
- `title` (required) - The title of a snippet
- `file_name` (required) - The name of a snippet file
- `code` (required) - The content of a snippet
+- `visibility_level` (required) - The snippet's visibility
## Update snippet
@@ -74,6 +88,7 @@ Parameters:
- `title` (optional) - The title of a snippet
- `file_name` (optional) - The name of a snippet file
- `code` (optional) - The content of a snippet
+- `visibility_level` (optional) - The snippet's visibility
## Delete snippet