You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/v3/gists.md
+16-27Lines changed: 16 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,9 +36,10 @@ List the authenticated user's starred gists:
36
36
37
37
### Parameters
38
38
39
-
since
40
-
: _Optional_**string** of a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ
41
-
Only gists updated at or after this time are returned.
39
+
Name | Type | Description | Required? | Default
40
+
----|------|--------------|-----------|---------
41
+
`since`|`string` | A timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`. Only gists updated at or after this time are returned.| |
42
+
42
43
43
44
### Response
44
45
@@ -62,19 +63,13 @@ _Note_: When using the [v3 media type][2] the "user" field will become "owner"
62
63
63
64
### Input
64
65
65
-
description
66
-
: _Optional_**string**
67
-
68
-
public
69
-
: _Optional_**boolean** - Default: `false`.
70
-
71
-
files
72
-
: _Required_**hash** - Files that make up this gist. The key of which
73
-
should be a _required_**string** filename and the value another
74
-
_required_**hash** with parameters:
66
+
Name | Type | Description | Required? | Default
67
+
----|------|--------------|-----------|---------
68
+
`description`|`string` | A description of the gist.| |
69
+
`public`|`boolean` | Indicates whether the gist is public. | |`false`
70
+
`files`|`hash` | Files that make up this gist.|**YES**|
75
71
76
-
content
77
-
: _Required_**string** - File contents.
72
+
The keys in the `files` hash are the `string` filename, and the value is another `hash` with a key of `contents`, and a value of the file contents. For example:
78
73
79
74
<%= json \
80
75
:description => "the description for this gist",
@@ -98,19 +93,13 @@ format of the automatic naming scheme that Gist uses internally.
98
93
99
94
### Input
100
95
101
-
description
102
-
: _Optional_**string**
103
-
104
-
files
105
-
: _Optional_**hash** - Files that make up this gist. The key of which
106
-
should be an _optional_**string** filename and the value another
107
-
_optional_**hash** with parameters:
108
-
109
-
content
110
-
: _Optional_**string** - Updated file contents.
96
+
Name | Type | Description | Required? | Default
97
+
----|------|--------------|-----------|---------
98
+
`description`|`string` | A description of the gist.| |
99
+
`files`|`hash` | Files that make up this gist. The key of which should be an _optional_**string** filename and the value another _optional_**hash** with parameters:| |
100
+
`content`|`string` | Updated file contents.| |
101
+
`filename`|`string` | New name for this file.| |
111
102
112
-
filename
113
-
: _Optional_**string** - New name for this file.
114
103
115
104
NOTE: All files from the previous version of the gist are carried over by
116
105
default if not included in the hash. Deletes can be performed by
0 commit comments