/v0/accounts/:name/avatar (POST)

POST

/v0/accounts/:name/avatar

const url = 'http://localhost:3000/v0/accounts/:name/avatar';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"medium_id":"38477395"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url http://localhost:3000/v0/accounts/:name/avatar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "medium_id": "38477395" }'

Authorizations

bearer

Parameters

Path Parameters

name

required

Characters must be [A-Za-z0-9-.] The first and last characters must be [A-Za-z0-9-.]

string

>= 3 characters <= 64 characters

Example

example_man

Characters must be [A-Za-z0-9-.] The first and last characters must be [A-Za-z0-9-.]

Request Body

application/json

object

medium_id

required

Medium ID

string

Example

38477395

Responses

204

No Content

403

Forbidden

application/json

You can not do this action.

object

error

required

You can’t do this action.

string

Allowed values: NO_PERMISSION

Example

{
  "error": "NO_PERMISSION"
}

404

Not Found

application/json

Account not found

object

error

required

Any of:

string
string

Account not found.

string

Allowed values: ACCOUNT_NOT_FOUND

Example

{
  "error": "ACCOUNT_NOT_FOUND"
}

500

Internal Server Error

application/json

object

error

required

Internal server error.

string

Allowed values: INTERNAL_ERROR

Example

{
  "error": "INTERNAL_ERROR"
}