0

Get content state settings for space

by
Published Oct 17, 2025

Get object describing whether content states are allowed at all, if custom content states or space content states are restricted, and a list of space content states allowed for the space if they are not restricted. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Admin' permission for the space.

Script confluence
  • Submitted by hugo697 Bun
    Created 284 days ago
    1
    //native
    2
    type Confluence = {
    3
    	email: string
    4
    	apiToken: string
    5
    	domain: string
    6
    }
    7
    /**
    8
     * Get content state settings for space
    9
     * Get object describing whether content states are allowed at all, if custom content states or space content states
    10
    are restricted, and a list of space content states allowed for the space if they are not restricted.
    11
    
    
    12
    **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
    13
    'Admin' permission for the space.
    14
     */
    15
    export async function main(auth: Confluence, spaceKey: string) {
    16
    	const url = new URL(`https://${auth.domain}/wiki/rest/api/space/${spaceKey}/state/settings`)
    17
    
    
    18
    	const response = await fetch(url, {
    19
    		method: 'GET',
    20
    		headers: {
    21
    			Authorization: 'Basic ' + btoa(`${auth.email}:${auth.apiToken}`)
    22
    		},
    23
    		body: undefined
    24
    	})
    25
    	if (!response.ok) {
    26
    		const text = await response.text()
    27
    		throw new Error(`${response.status} ${text}`)
    28
    	}
    29
    	return await response.json()
    30
    }
    31