Upload a mind banner

Upload or replace the mind's banner. Accepts PNG, JPEG, WebP or SVG up to 5 MB. Replacing removes the previous file. Returns the updated mind.

Gated as a write on the mind: its owner, or someone holding an admin grant. A viewer the mind was shared with cannot reskin it for everyone else.

PUT

https://truememory-api.mvstg.com/minds/{mind_id}/banner

View as Markdown

Authorization

HTTPBearerHTTPrequired

Path parameters

mind_idstringrequired
format: uuid

Header parameters

X-App-Idoptional
One of the following:
string
null
}
X-On-Behalf-Ofoptional
One of the following:
string
null
}
X-External-User-Idoptional
One of the following:
string
null
}

Request bodyFORM-DATArequired

filestringrequired

Returns

200

Successful Response

JSON

idstringrequired
owner_typeuserororgrequired
owner_idstringrequired
slugstringrequired
namestringrequired
created_atstringrequired
format: date-time
updated_atstringrequired
format: date-time
skill_idsarray ofstringrequired
Ids of skills, for clients seeding a multi-select.
app_idoptional
One of the following:
string
null
}
descriptionoptional
One of the following:
string
null
}
emojioptional
One of the following:
string
null
}
usage_hintoptional
One of the following:
string
null
}
visibilityoptionalprivateorapporpublic
default: "private"
banner_image_urloptional
One of the following:
string
null
}
skillsoptionalarray ofobject
- idstringrequired
- keystringrequired
- namestringrequired
}
brain_countoptionalinteger
default: 0

422

Validation Error

JSON

detailoptionalarray ofobject
- locarray ofrequired
  One of the following:
  string
  integer
- msgstringrequired
- typestringrequired
- inputoptionalunknown
- ctxoptionalobject
}

{ "id": "string", "owner_type": "user", "owner_id": "string", "app_id": "string", "slug": "string", "name": "string", "description": "string", "emoji": "string", "usage_hint": "string", "visibility": "private", "banner_image_url": "string", "skills": [ { "id": "string", "key": "string", "name": "string" } ], "brain_count": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "skill_ids": [ "string" ] }