> ## Documentation Index > Fetch the complete documentation index at: https://docs.member.dev/llms.txt > Use this file to discover all available pages before exploring further. # Admin Update Space Appearance ## OpenAPI ````yaml /openapi/mio-openapi.json patch /api/v1/admin/teams/{team_id}/hubs/{hub_id}/spaces/{space_id}/appearance openapi: 3.1.0 info: description: >- Production API reference for Membership.io. Use the authored guides for workflows and the generated endpoint pages for exact parameters and schemas. title: Membership.io API version: 0.1.0 servers: - description: Production url: https://api.member.dev security: - bearerAuth: [] paths: /api/v1/admin/teams/{team_id}/hubs/{hub_id}/spaces/{space_id}/appearance: patch: tags: - community-spaces-admin summary: Admin Update Space Appearance operationId: >- community_spaces_admin.patch_community_spaces_admin_patch_admin_teams_by_team_id_hubs_by_hub_id_spaces_by_space_id_appearance parameters: - in: path name: space_id required: true schema: maxLength: 36 title: Space Id type: string - in: path name: team_id required: true schema: title: Team Id type: string - in: path name: hub_id required: true schema: title: Hub Id type: string - in: header name: If-Match required: false schema: anyOf: - type: string - type: 'null' title: If-Match requestBody: content: application/vnd.api+json: schema: $ref: '#/components/schemas/SpaceAppearanceWriteEnvelope' required: true responses: '200': content: application/vnd.api+json: schema: $ref: >- #/components/schemas/JsonApiResponse_SpaceAppearanceAttributes_ description: Successful Response headers: ETag: description: >- Opaque strong validator of this space's name and banner. Send it verbatim as If-Match on the next PATCH .../appearance to make that write conditional. Other space fields never move it. schema: type: string '400': content: application/vnd.api+json: schema: $ref: '#/components/schemas/JsonApiErrorResponse' description: invalid_if_match '404': content: application/vnd.api+json: schema: $ref: '#/components/schemas/JsonApiErrorResponse' description: space_not_found '409': content: application/vnd.api+json: schema: $ref: '#/components/schemas/JsonApiErrorResponse' description: stale_space_appearance, or a body id that is not the path space '422': content: application/vnd.api+json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - HTTPBearer: [] components: schemas: SpaceAppearanceWriteEnvelope: description: >- JSON:API envelope: {data: {type: "space_appearances", id?, attributes: {name?, banner?}}}. ``id`` is optional; when sent it must equal the space id in the path. properties: data: $ref: '#/components/schemas/SpaceAppearanceWriteData' required: - data title: SpaceAppearanceWriteEnvelope type: object JsonApiResponse_SpaceAppearanceAttributes_: properties: data: $ref: '#/components/schemas/JsonApiResource_SpaceAppearanceAttributes_' included: anyOf: - items: {} type: array - type: 'null' title: Included links: anyOf: - $ref: '#/components/schemas/JsonApiLinks' - type: 'null' meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta required: - data title: JsonApiResponse[SpaceAppearanceAttributes] type: object JsonApiErrorResponse: description: Error JSON:API response. properties: errors: items: $ref: '#/components/schemas/JsonApiError' title: Errors type: array meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta required: - errors title: JsonApiErrorResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object SpaceAppearanceWriteData: properties: attributes: $ref: '#/components/schemas/SpaceAppearanceWriteAttributes' id: description: >- Optional. When present it must equal the id of the resource this request updates; a different id is a 409 resource_id_mismatch and null is a 422. title: Id type: string type: const: space_appearances title: Type type: string required: - type - attributes title: SpaceAppearanceWriteData type: object JsonApiResource_SpaceAppearanceAttributes_: properties: attributes: $ref: '#/components/schemas/SpaceAppearanceAttributes' id: title: Id type: string links: anyOf: - $ref: '#/components/schemas/JsonApiLinks' - type: 'null' meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta relationships: anyOf: - additionalProperties: true type: object - type: 'null' title: Relationships type: title: Type type: string required: - id - type - attributes title: JsonApiResource[SpaceAppearanceAttributes] type: object JsonApiLinks: properties: self: anyOf: - type: string - type: 'null' title: Self title: JsonApiLinks type: object JsonApiError: properties: code: anyOf: - type: string - type: 'null' title: Code detail: anyOf: - type: string - type: 'null' title: Detail id: anyOf: - type: string - type: 'null' title: Id meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta source: anyOf: - additionalProperties: type: string type: object - type: 'null' title: Source status: title: Status type: string title: title: Title type: string required: - status - title title: JsonApiError type: object ValidationError: properties: ctx: title: Context type: object input: title: Input loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object SpaceAppearanceWriteAttributes: additionalProperties: false properties: banner: anyOf: - additionalProperties: true type: object - type: 'null' description: >- This space's own discussions banner, the same shape as the hub's settings.discussionsBanner: {background?, gradient?, ink?, inkColor?}. background and gradient take a page section's background vocabulary (the catalog's shared:background, every type but 'none', and shared:gradient); ink is 'auto' | 'light' | 'dark' | 'primary' | 'custom' and inkColor a '#RRGGBB' hex read when ink is 'custom'. null clears it, and the hub-wide banner is shown again. title: Banner name: description: The name members see for this space. The slug does not change. maxLength: 120 minLength: 1 title: Name type: string title: SpaceAppearanceWriteAttributes type: object SpaceAppearanceAttributes: properties: banner: anyOf: - additionalProperties: true type: object - type: 'null' title: Banner name: anyOf: - type: string - type: 'null' title: Name title: SpaceAppearanceAttributes type: object securitySchemes: bearerAuth: bearerFormat: JWT or mio_sk API key description: >- Send platform JWTs, contact JWTs, or team API keys as `Authorization: Bearer `. scheme: bearer type: http HTTPBearer: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.