Skip to content

Commit

Permalink
build docs
Browse files Browse the repository at this point in the history
  • Loading branch information
@anthonyshchang
anthonyshchang committed Dec 5, 2023
1 parent 2263b9d commit 866917f
Show file tree
Hide file tree
Showing 2 changed files with 311 additions and 5 deletions.
315 changes: 311 additions & 4 deletions doc/compiled.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -733,6 +733,12 @@
"$ref": "#/components/schemas/project_short"
}
},
"value_options": {
"type": "array",
"items": {
"type": "string"
}
},
"created_at": {
"type": "string",
"format": "date-time"
Expand All @@ -744,9 +750,9 @@
},
"example": {
"id": "abcd1234cdef1234abcd1234cdef1234",
"name": "Character Age",
"description": "Age of character in seconds",
"data_type": "Text value",
"name": "Nuts",
"description": "A healthy snack for all ages",
"data_type": "multi_select",
"user": {
"id": "abcd1234cdef1234abcd1234cdef1234",
"username": "joe.doe",
Expand All @@ -762,6 +768,11 @@
"created_at": "2015-01-28T09:52:53Z",
"updated_at": "2015-01-28T09:52:53Z"
}
],
"value_options": [
"apple",
"banana",
"coconut"
]
}
},
Expand Down Expand Up @@ -6169,7 +6180,303 @@
"x-cli-version": "2.9"
}
},
"/accounts/{account_id}/custom_metadata/labels/{:id}": {
"/accounts/{account_id}/custom_metadata/labels/{id}": {
"get": {
"summary": "Get a single property",
"description": "Get details of a single custom property.",
"operationId": "custom_metadata_property/show",
"tags": [
"Custom Metadata"
],
"parameters": [
{
"$ref": "#/components/parameters/X-PhraseApp-OTP"
},
{
"$ref": "#/components/parameters/account_id"
},
{
"$ref": "#/components/parameters/id"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/custom_metadata_property"
}
}
},
"headers": {
"X-Rate-Limit-Limit": {
"$ref": "#/components/headers/X-Rate-Limit-Limit"
},
"X-Rate-Limit-Remaining": {
"$ref": "#/components/headers/X-Rate-Limit-Remaining"
},
"X-Rate-Limit-Reset": {
"$ref": "#/components/headers/X-Rate-Limit-Reset"
}
}
},
"400": {
"$ref": "#/components/responses/400"
},
"404": {
"$ref": "#/components/responses/404"
},
"429": {
"$ref": "#/components/responses/429"
}
},
"x-code-samples": [
{
"lang": "Curl",
"source": "curl \"https://api.phrase.com/v2/accounts/:account_id/custom_metadata/labels/:id\" \\\n -u USERNAME_OR_ACCESS_TOKEN"
},
{
"lang": "CLI v2",
"source": "phrase custom_metadata_labels show \\\n--account_id <account_id> \\\n--id <id> \\\n--access_token <token>"
}
],
"x-cli-version": "2.9"
},
"post": {
"summary": "Create a property",
"description": "Create a new custom metadata property.",
"operationId": "custom_metadata_property/create",
"tags": [
"Custom Metadata"
],
"parameters": [
{
"$ref": "#/components/parameters/X-PhraseApp-OTP"
},
{
"$ref": "#/components/parameters/account_id"
},
{
"$ref": "#/components/parameters/id"
},
{
"description": "name of the property",
"example": [
"Fruit"
],
"name": "name",
"in": "query",
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/data_type"
},
{
"description": "description of property",
"example": [
"A healthy snack for all ages"
],
"name": "description",
"in": "query",
"schema": {
"type": "string"
}
},
{
"description": "ids of projects that the property belongs to",
"example": [
"abcd1234cdef1234abcd1234cdef1234"
],
"name": "project_ids",
"in": "query",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"description": "value options of property (only applies to single or multi select properties)",
"example": [
"Apple",
"Banana",
"Coconut"
],
"name": "value_options",
"in": "query",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/custom_metadata_property"
}
}
},
"headers": {
"X-Rate-Limit-Limit": {
"$ref": "#/components/headers/X-Rate-Limit-Limit"
},
"X-Rate-Limit-Remaining": {
"$ref": "#/components/headers/X-Rate-Limit-Remaining"
},
"X-Rate-Limit-Reset": {
"$ref": "#/components/headers/X-Rate-Limit-Reset"
}
}
},
"400": {
"$ref": "#/components/responses/400"
},
"404": {
"$ref": "#/components/responses/404"
},
"422": {
"$ref": "#/components/responses/422"
},
"429": {
"$ref": "#/components/responses/429"
}
},
"x-code-samples": [
{
"lang": "Curl",
"source": "curl \"https://api.phrase.com/v2/accounts/:account_id/custom_metadata/labels/:id\" \\\n -u USERNAME_OR_ACCESS_TOKEN \\\n -X POST \\\n -d '{\"name\":\"Fruit\",\"description\":\"A healthy snack for all ages\",\"project_ids\":[\"1\",\"2\",\"3\"],\"value_options\":[\"apple\",\"banana\",\"coconut\"]}' \\\n -H 'Content-Type: application/json'"
},
{
"lang": "CLI v2",
"source": "phrase custom_metadata_properties create \\\n--account_id <account_id> \\\n--id <id> \\\n--data '{\"name\":\"Fruit\",\"description\":\"A healthy snack for all ages\",\"project_ids\":[\"1\",\"2\",\"3\"],\"value_options\":[\"apple\",\"banana\",\"coconut\"]}' \\\n--access_token <token>"
}
],
"x-cli-version": "2.9"
},
"patch": {
"summary": "Update a property",
"description": "Update an existing custom metadata property.",
"operationId": "custom_metadata_property/update",
"tags": [
"Custom Metadata"
],
"parameters": [
{
"$ref": "#/components/parameters/X-PhraseApp-OTP"
},
{
"$ref": "#/components/parameters/account_id"
},
{
"$ref": "#/components/parameters/id"
},
{
"description": "name of the property",
"example": [
"Fruit"
],
"name": "name",
"in": "query",
"schema": {
"type": "string"
}
},
{
"description": "description of property",
"example": [
"A healthy snack for all ages"
],
"name": "description",
"in": "query",
"schema": {
"type": "string"
}
},
{
"description": "ids of projects that the property belongs to",
"example": [
"abcd1234cdef1234abcd1234cdef1234"
],
"name": "project_ids",
"in": "query",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"description": "value options of property (only applies to single or multi select properties)",
"example": [
"Apple",
"Banana",
"Coconut"
],
"name": "value_options",
"in": "query",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/custom_metadata_property"
}
}
},
"headers": {
"X-Rate-Limit-Limit": {
"$ref": "#/components/headers/X-Rate-Limit-Limit"
},
"X-Rate-Limit-Remaining": {
"$ref": "#/components/headers/X-Rate-Limit-Remaining"
},
"X-Rate-Limit-Reset": {
"$ref": "#/components/headers/X-Rate-Limit-Reset"
}
}
},
"400": {
"$ref": "#/components/responses/400"
},
"404": {
"$ref": "#/components/responses/404"
},
"429": {
"$ref": "#/components/responses/429"
}
},
"x-code-samples": [
{
"lang": "Curl",
"source": "curl \"https://api.phrase.com/v2/accounts/:account_id/custom_metadata/labels/:id\" \\\n -u USERNAME_OR_ACCESS_TOKEN \\\n -X PATCH \\\n -d '{\"name\":\"Fruit\",\"description\":\"A healthy snack for all ages\",\"project_ids\":[\"1\",\"2\",\"3\"],\"value_options\":[\"apple\",\"banana\",\"coconut\"]}' \\\n -H 'Content-Type: application/json'"
},
{
"lang": "CLI v2",
"source": "phrase custom_metadata_properties update \\\n--account_id <account_id> \\\n--id <id> \\\n--data '{\"name\":\"Fruit\",\"description\":\"A healthy snack for all ages\",\"project_ids\":[\"1\",\"2\",\"3\"],\"value_options\":[\"apple\",\"banana\",\"coconut\"]}' \\\n--access_token <token>"
}
],
"x-cli-version": "2.9"
},
"delete": {
"summary": "Destroy property",
"description": "Destroy a custom metadata property of an account.\n\nThis endpoint is only available to accounts with advanced plans or above.\n",
Expand Down
1 change: 0 additions & 1 deletion paths.yaml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,6 @@
"/accounts/{account_id}/custom_metadata/labels":
get:
"$ref": "./paths/custom_metadata_properties/index.yaml"
<<<<<<< HEAD
"/accounts/{account_id}/custom_metadata/labels/{id}":
get:
"$ref": "./paths/custom_metadata_properties/show.yaml"
Expand Down

0 comments on commit 866917f

Please sign in to comment.